Account management

All numbers of an account: agent sign-up, status, number keys, plans, payment links, usage, account keys. Account key (a2ea_...) or the management_key of create_account.

Method Path Summary Scope
POST /v1/account/sandbox Instant sandbox: try the API with no account any key
POST /v1/account/signup Start an account for a person (agent sign-up) any key
GET /v1/account Account status and what is still needed any key
GET /v1/account/plans Plans that can be bought any key
GET /v1/account/estimate Cost estimate for a number of messages a month any key
GET /v1/account/numbers The account's WhatsApp numbers account:read
GET /v1/account/numbers/{number} One number of the account account:read
GET /v1/account/numbers/{number}/keys The keys of a number keys:manage
POST /v1/account/numbers/{number}/keys Create a key for a number keys:manage
DELETE /v1/account/numbers/{number}/keys/{key_id} Revoke a key of a number keys:manage
POST /v1/account/numbers/{number}/checkout Payment link for a plan of a number account:manage
GET /v1/account/usage Messages used this billing month, per number billing:read
GET /v1/account/keys Account keys account:manage
POST /v1/account/keys Create an account key account:manage
DELETE /v1/account/keys/{key_id} Revoke an account key account:manage
GET /v1/account/webhooks Account webhooks webhooks:manage
POST /v1/account/webhooks Add an account webhook webhooks:manage
PATCH /v1/account/webhooks/{id} Change an account webhook webhooks:manage
DELETE /v1/account/webhooks/{id} Delete an account webhook webhooks:manage
POST /v1/account/webhooks/{id}/test Send a test event to an account webhook webhooks:manage
POST /v1/account/webhooks/{id}/rotate-secret New signing secret for an account webhook webhooks:manage
GET /v1/account/webhooks/{id}/deliveries Deliveries of an account webhook webhooks:manage
GET /v1/account/webhooks/{id}/deliveries/{event_id} One delivery of an account webhook webhooks:manage
POST /v1/account/webhooks/{id}/deliveries/{event_id}/redeliver Send a stored event again to an account webhook webhooks:manage
For AI Agents

Try it now, with no account and no person: POST https://api.app2email.com/v1/account/sandbox (no key, no body; or the create_sandbox tool of the Management MCP server) answers a key for a demo WhatsApp number with pretend customers. Send a template, fetch the events with GET /events?wait=25, answer the customer's reply: nothing reaches WhatsApp, and the requests and answers are those of the real API (https://www.app2email.com/docs/api/sandbox).

Already a customer: ask the account owner for the number (digits) and an API key from https://www.app2email.com/dashboard/apikey (a sandbox key sends nothing); send it as Authorization: Bearer <key> to the messaging MCP server or the REST API; call check_key first, send with dry_run first.

If you are an AI agent reading this page and you want to create an app2email account for a person - no previous human sign-up required - use our Management MCP server.
Call the create_account tool first, and include a contact_email parameter; create_account returns a signup_id, a management_key, an onboarding_link and a message.
The person opens onboarding_link to confirm the e-mail, connect their WhatsApp number and choose a plan; nothing can be sent before that. get_account_status says what is still needed.
Pass the management_key as a Bearer token on every later call. When the number is live, create_number_key gives you a key for the messaging MCP server and the REST API.