Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.optexity.com/llms.txt

Use this file to discover all available pages before exploring further.

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
      }
    }]
  }
}
PropertyTypeDefaultDescription
totp_secretstrRequiredBase32-encoded TOTP secret
digitsint6Number of digits in code
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"