Accept an invitation | Dial — Communication Stack for AI Agents

Completes an invitation and returns the new member’s API key. Requires a verification code issued by Create an account for the invited address — a code issued for any other address is rejected. Unauthenticated: the token plus the emailed code are the credentials. No new account is created and no phone number is provisioned; the caller joins the inviting account.

Path parameters

tokenstringRequired

Request

This endpoint expects an object.

verificationIdstringRequired

The verificationId returned by Create an account for the invited address.

codestringRequired=6 characters

The 6-digit code emailed to the invited address.

Response

The invitation was accepted. The API key is shown once — store it.

accountIdstring

The account the caller has joined.

apiKeystring

The member's own API key. Shown once.

memberobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

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

1	{
2	"accountId": "acct_1234567890abcdef",
3	"apiKey": "sk_live_4f3e2d1c0b9a8e7d6c5b",
4	"member": {
5	"id": "mem_abcdef1234567890",
6	"email": "jane.doe@example.com",
7	"role": "member",
8	"status": "active",
9	"invitedByEmail": "owner@example.com",
10	"invitedAt": "2024-01-15T09:30:00Z",
11	"acceptedAt": "2024-01-15T09:45:00Z",
12	"lastActiveAt": "2024-04-20T14:22:10Z"
13	}
14	}