v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Agent

Create an emailless agent account

Creates an emailless agent account without authentication and returns a one-time API key (prefixed prim_) plus a provisioned managed inbox. The account is on the agent plan: reply-only (it can send only to addresses that have already sent it authenticated mail) with tight send limits. Use the returned api_key as a Bearer token on later calls. The account can be upgraded to a full developer account by confirming an email through the claim flow. This endpoint does not require an API key.

post/agent/accounts

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Request body

terms_acceptedtrue required

Must be true to accept the Terms of Service and Privacy Policy.

device_namestring

Optional label for the device or agent creating the account.

Response

Agent account created; the API key is returned once

successtrue required