Verify a sign-up code | Dial — Communication Stack for AI Agents

Verifies the one-time code for a verificationId. On first verification the account is created, an API key is issued, and a first phone number is provisioned. The API key is returned only once — store it immediately.

When a new number is provisioned, inboundInstruction is optional — it becomes that number’s inbound voice-agent prompt, and a default greeting is used if you omit it. For an existing account (no new number provisioned) inboundInstruction is ignored.

Verifies the one-time code for a `verificationId`. On first verification the account is created, an API key is issued, and a first phone number is provisioned. **The API key is returned only once — store it immediately.** When a new number is provisioned, `inboundInstruction` is **optional** — it becomes that number's inbound voice-agent prompt, and a default greeting is used if you omit it. For an existing account (no new number provisioned) `inboundInstruction` is ignored.

Request

This endpoint expects an object.

$	curl -X POST https://api.getdial.ai/api/v1/auth/verify \
>	-H "Content-Type: application/json" \
>	-d '{
>	"verificationId": "verif_9f8b7c6d5e4a3b2c1d0e",
>	"code": "482915"
>	}'

1	{
2	"apiKey": "sk_live_4a7f8e9d2c3b1a0f6e5d",
3	"accountId": "acct_1234567890abcdef",
4	"phoneNumber": "+14155550123",
5	"phoneNumberId": "phnum_0987654321fedcba",
6	"message": "Verification successful. Your account has been created and your API key has been issued."
7	}

Request

Response

Errors