Time-Based One-Time Password (TOTP) Integration

Generate TOTP codes from authenticator apps (Google Authenticator, Microsoft Authenticator, Authy) for 2FA.

If you are looking for 2FA codes from Email or Slack, please refer to the Two-Factor Authentication Integration documentation.

Get Your TOTP Secret

Follow this guide to extract your TOTP secret: TOTP Secret Extraction Guide

Direct TOTP Secret

Provide the TOTP secret directly in secure_parameters:

{
  "secure_parameters": {
    "auth_code": [{
      "totp": {
        "totp_secret": "YOUR_BASE32_SECRET",
        "digits": 6
      }
    }]
  }
}

Property	Type	Default	Description
`totp_secret`	`str`	Required	Base32-encoded TOTP secret
`digits`	`int`	`6`	Number of digits in code

TOTP via 1Password (Recommended)

Store the TOTP secret in 1Password for better security:

{
  "secure_parameters": {
    "auth_code": [{
      "onepassword": {
        "type": "totp_secret",
        "vault_name": "my_vault",
        "item_name": "my_login",
        "field_name": "totp_secret",
        "digits": 6
      }
    }]
  }
}

See 1Password Integration for setup instructions.

Using in Automations

Reference the TOTP code like any parameter:

{
  "type": "action_node",
  "interaction_action": {
    "input_text": {
      "command": "get_by_label(\"Verification Code\")",
      "input_text": "{auth_code[0]}",
      "prompt_instructions": "Enter the 2FA code"
    }
  }
}

Complete Example

Here’s a complete automation that authenticates with a TOTP-protected service:

{
  "url": "https://sample.com/",
  "parameters": {
    "input_parameters": {
      "username": [
        "provider_username"
      ]
    },
    "secure_parameters": {
      "auth_code": [
        {
          "totp": {
            "totp_secret": "YUNFZZZH"
          }
        }
      ]
    },
    "generated_parameters": {}
  },
  "nodes": [
    {
      "type": "action_node",
      "interaction_action": {
        "input_text": {
          "command": "get_by_test_id(\"totp\")",
          "prompt_instructions": "Enter the 2FA code",
          "input_text": "{auth_code[0]}"
        }
      }
    }
  ]
}

This example:

Uses a direct TOTP secret (YUNFZZZH) from secure_parameters
Accepts a username as an input_parameter
Enters the generated TOTP code into the input field identified by test_id="totp"

Quickstart

Building Automations

Action Types

Inference

Advanced

FAQs

Time-Based One-Time Password (TOTP) Integration

Get Your TOTP Secret

Direct TOTP Secret

TOTP via 1Password (Recommended)

Using in Automations

Complete Example

​Get Your TOTP Secret

​Direct TOTP Secret

​TOTP via 1Password (Recommended)

​Using in Automations

​Complete Example

Get Your TOTP Secret

Direct TOTP Secret

TOTP via 1Password (Recommended)

Using in Automations

Complete Example