API referenceEmail messages
Not offered: it needs contacts scopes no mailbox grants. Always 422 errors/not_supported_by_provider.
X-API-KEY<token>
Your API key from the console (gw_live_…).
In: header
Query Parameters
account_id*string
The mailbox (em_…).
Response Body
application/json
curl -X GET "https://example.com/email/api/v1/emails/contacts?account_id=em_gX2kP9qL4mT7vB1nR8sW3yZ"{ "status": 422, "type": "errors/cannot_resend_yet", "code": "invite-limit", "title": "LinkedIn refused the invitation.", "detail": "LinkedIn refused the invitation."}Download an attachment GET
The file's bytes, as a download (`Content-Disposition: attachment`).
List emails GET
Live from the mailbox, newest first. One folder at a time: `folder` (its `provider_id` or `emf_` id), else `role`'s folder, else All Mail where the mailbox has it (Gmail), else INBOX. Items are `1_meta` (no body); `include_body=true` (ours) fetches the bodies when `limit` is 25 or less. The filters other than the folder search the folder.