# Telnyx Sign-up

> Onboarding for both humans and AI agents. Humans use the portal signup
> flow; agents use the Proof-of-Work bot signup flow.

## What this surface is for
- Creating a new Telnyx account (human or agent)
- Discovering the agent-specific bot signup path
- Verifying email and obtaining an API key

## For agents (preferred)
- Agent signup runbook: https://telnyx.com/agent-signup.md
- Bot signup challenge: https://api.telnyx.com/v2/pow_signup_challenge
- Toolkit reference: https://github.com/team-telnyx/telnyx-toolkit/tree/main/getting-started/telnyx-bot-signup
- Discovery: https://telnyx.com/.well-known/agent-access.json

## For humans
- Portal signup: https://telnyx.com/sign-up
- Account creation docs: https://developers.telnyx.com/docs/account-setup/create-account

## Authentication
- Signup endpoints do not require authentication. After signup, generate
  an API key via /v2/api_keys with the temporary session token. See
  https://telnyx.com/agent-signup.md for the full flow.

## Recovery
- Resend magic link: POST /v2/bot_signup/resend_magic_link (max 3, 60s
  cooldown). See https://telnyx.com/agent-signup.md.

## Agent fast path
- Agent entry point: https://telnyx.com/agents/start
- Site-wide index: https://telnyx.com/llms.txt