Sign in
Bot Signup

Register via bot signup

Creates a freemium Telnyx account through the agentic signup flow. The request must carry a valid answer to a previously issued bot challenge (bot_challenge_nonce and bot_challenge_answer), accept the terms of service, and echo the exact terms-and-conditions and privacy-policy URLs returned by the challenge endpoint. When EU consent enforcement is enabled, terms_of_service_eu and terms_and_conditions_eu_url are also required. On success a one-time sign-in (magic) link is emailed to the address provided; if the email address belongs to an existing account, a sign-in link is sent instead of creating a duplicate account. email may only be omitted when placeholder-email registration is enabled server-side. This endpoint is public and unauthenticated, gated by the freemium feature flags and per-country availability, and subject to per-IP and per-domain registration limits.

post/v2/bot_signup

Request body

emailstring email

Email address for the new account. The magic link is sent here. May only be omitted when placeholder-email registration is enabled server-side.

terms_of_servicetrue required

Must be true to accept the terms of service.

terms_and_conditions_urlstring required

Must exactly match the terms-and-conditions URL returned by the challenge endpoint.

privacy_policy_urlstring required

Must exactly match the privacy-policy URL returned by the challenge endpoint.

terms_of_service_eutrue

EU terms-of-service acceptance. Required when EU consent enforcement is enabled.

terms_and_conditions_eu_urlstring

EU terms-and-conditions URL. Required when EU consent enforcement is enabled.

bot_challenge_noncestring uuid required

Nonce from a previously issued bot challenge.

bot_challenge_answerstring required

Answer to the issued bot challenge.

Example request

{
  "email": "agent-owner@example.com",
  "terms_of_service": true,
  "terms_and_conditions_url": "https://telnyx.com/terms-and-conditions-of-service",
  "privacy_policy_url": "https://telnyx.com/privacy-policy",
  "terms_of_service_eu": true,
  "terms_and_conditions_eu_url": "https://telnyx.com/terms-and-conditions-of-service-eu",
  "bot_challenge_nonce": "c6feda4e-6501-4db9-a21f-665e5b4ce2ba",
  "bot_challenge_answer": "35"
}

Response

Registration accepted and a magic link emailed.

successboolean required

Whether the request was accepted.

messagestring required

Human-readable status message.

Example response

{
  "success": true,
  "message": "A one-time sign-in link has been sent to your email address."
}

Changes