Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Verify

Create a Verify profile

Creates a new Verify profile to associate verifications with.

post/verify_profiles

Request body

daily_spend_limitnumber

The maximum daily spend allowed on this verify profile, in USD.

daily_spend_limit_enabledboolean

Whether the daily spend limit is enforced for this verify profile.

languagestring
namestring required
webhook_failover_urlstring
webhook_urlstring

Example request

{
  "call": {
    "app_name": "Example Secure App",
    "code_length": 6,
    "default_verification_timeout_secs": 300,
    "messaging_template_id": "0abb5b4f-459f-445a-bfcd-488998b7572d",
    "whitelisted_destinations": [
      "US",
      "CA"
    ]
  },
  "daily_spend_limit": 100,
  "daily_spend_limit_enabled": true,
  "flashcall": {
    "app_name": "Example Secure App",
    "default_verification_timeout_secs": 300,
    "whitelisted_destinations": [
      "US",
      "CA"
    ]
  },
  "language": "en-US",
  "name": "Test Profile",
  "sms": {
    "app_name": "Example Secure App",
    "code_length": 6,
    "default_verification_timeout_secs": 300,
    "messaging_template_id": "0abb5b4f-459f-445a-bfcd-488998b7572d",
    "whitelisted_destinations": [
      "US",
      "CA"
    ]
  },
  "webhook_failover_url": "http://example.com/webhook/failover",
  "webhook_url": "http://example.com/webhook",
  "whatsapp": {
    "default_verification_timeout_secs": 300,
    "sender_phone_number": "+13035551234",
    "template_id": "authentication_template_id",
    "waba_id": "1234567890",
    "whitelisted_destinations": [
      "US",
      "CA"
    ]
  }
}

Response

Expected Verify profile response to a valid request.

Example response

{
  "data": {
    "call": {
      "app_name": "Example Secure App",
      "code_length": 6,
      "default_verification_timeout_secs": 300,
      "messaging_template_id": "0abb5b4f-459f-445a-bfcd-488998b7572d",
      "whitelisted_destinations": [
        "US",
        "CA"
      ]
    },
    "created_at": "2020-09-14T17:03:32.965812",
    "daily_spend_limit": 100,
    "daily_spend_limit_enabled": true,
    "flashcall": {
      "app_name": "Example Secure App",
      "default_verification_timeout_secs": 300
    },
    "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
    "language": "en-US",
    "name": "Test Profile",
    "record_type": "verification_profile",
    "sms": {
      "app_name": "Example Secure App",
      "code_length": 6,
      "default_verification_timeout_secs": 300,
      "messaging_template_id": "0abb5b4f-459f-445a-bfcd-488998b7572d",
      "whitelisted_destinations": [
        "US",
        "CA"
      ]
    },
    "updated_at": "2020-09-14T17:03:32.965812",
    "webhook_failover_url": "http://example.com/webhook/failover",
    "webhook_url": "http://example.com/webhook",
    "whatsapp": {
      "app_name": "Example Secure App",
      "code_length": 6,
      "default_verification_timeout_secs": 300,
      "messaging_template_id": "0abb5b4f-459f-445a-bfcd-488998b7572d",
      "sender_phone_number": "+13035551234",
      "template_id": "authentication_template_id",
      "waba_id": "1234567890",
      "whitelisted_destinations": [
        "US",
        "CA"
      ]
    }
  }
}