Partner

Resellers: the partner account, clients, their numbers and number keys, onboarding links, usage, payments, partner webhooks. Partner key (a2ep_...) from /reseller/api-keys.

Method Path Summary Scope
GET /v1/partner The partner account partner:read
PATCH /v1/partner Change the partner settings partner:manage
GET /v1/partner/clients Clients partner:read
POST /v1/partner/clients Create a client clients:manage
GET /v1/partner/clients/{client_id} One client partner:read
PATCH /v1/partner/clients/{client_id} Change a client clients:manage
GET /v1/partner/clients/{client_id}/usage Usage of a client billing:read
GET /v1/partner/numbers Numbers of your clients partner:read
GET /v1/partner/numbers/{number} One number partner:read
GET /v1/partner/numbers/{number}/usage Usage of a number billing:read
GET /v1/partner/numbers/{number}/keys Keys of a number keys:manage
POST /v1/partner/numbers/{number}/keys Create a key for a client's number keys:manage
DELETE /v1/partner/numbers/{number}/keys/{key_id} Revoke a key of a client's number keys:manage
POST /v1/partner/onboarding-links Onboarding link for a new or existing client clients:manage
GET /v1/partner/payments Client payments billing:read
GET /v1/partner/subscriptions Client plans billing:read
GET /v1/partner/webhooks Partner webhooks webhooks:manage
POST /v1/partner/webhooks Add a partner webhook webhooks:manage
PATCH /v1/partner/webhooks/{id} Change a partner webhook webhooks:manage
DELETE /v1/partner/webhooks/{id} Delete a partner webhook webhooks:manage
POST /v1/partner/webhooks/{id}/test Send a test event to a partner webhook webhooks:manage
POST /v1/partner/webhooks/{id}/rotate-secret New signing secret for a partner webhook webhooks:manage
GET /v1/partner/webhooks/{id}/deliveries Deliveries of a partner webhook webhooks:manage
GET /v1/partner/webhooks/{id}/deliveries/{event_id} One delivery of a partner webhook webhooks:manage
POST /v1/partner/webhooks/{id}/deliveries/{event_id}/redeliver Send a stored event again to a partner 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.