Core
Accounts API
2 endpoints under https://api.mailneo.co/api/v2. Every request carries your key in the X-API-Key header. The scope used here: accounts:read. Each endpoint below states the one it requires. Start with the guide →
Accounts
listEmailAccountsList connected sending accounts
The mailboxes this team can send from, with their health. Metadata only — no credentials are exposed by this or any other endpoint. Filter by status=ACTIVE to find accounts that can currently send.
https://api.mailneo.co/api/v2
GET
/accountsaccounts:readExample request
curl "https://api.mailneo.co/api/v2/accounts?limit=25&order=desc&sort=updated_at" \ -H "X-API-Key: $MAILNEO_API_KEY"
Authorization
- Required scope
accounts:read. A key without it is refused before the endpoint runs.- Credential
X-API-Key: mk_live_...Authorization: Bearer mk_live_...
Query parameters7
| Name | Type | Required | Notes |
|---|---|---|---|
| limit | integer | No | default 25 · 1–100 |
| cursor | string | No | max 256 chars |
| order | "asc" | "desc" | No | default "desc" |
| updated_since | string · date-time | No | ISO 8601 |
| sort | "updated_at" | "created_at" | No | default "updated_at" |
| status | "PENDING" | "ACTIVE" | "ERROR" | "SUSPENDED" | "REVOKED" | No | |
| provider | "GMAIL" | "GOOGLE_WORKSPACE" | "OUTLOOK" | "MICROSOFT" | "SMTP_AMAZON_SES" | "SMTP_SENDGRID" | … | No |
Response · 200
Success
data[]Each element of the array.
| Field | Type | Always present | Notes |
|---|---|---|---|
| object | "email_account" | Yes | |
| id | string | Yes | |
| string | Yes | ||
| display_name | string · nullable | Yes | |
| provider | string | Yes | |
| status | string | Yes | |
| last_checked_at | string · nullable | Yes | |
| created_at | string | Yes | |
| updated_at | string | Yes |
meta
| Field | Type | Always present | Notes |
|---|---|---|---|
| request_id | string | Yes | |
| has_more | boolean | Yes | |
| next_cursor | string · nullable | Yes | |
| synced_through | string | No |
Accounts
getEmailAccountRetrieve a sending account
Metadata only. No credential field is returned under any parameter.
https://api.mailneo.co/api/v2
GET
/accounts/{accountId}accounts:readExample request
curl "https://api.mailneo.co/api/v2/accounts/{accountId}" \
-H "X-API-Key: $MAILNEO_API_KEY"Authorization
- Required scope
accounts:read. A key without it is refused before the endpoint runs.- Credential
X-API-Key: mk_live_...Authorization: Bearer mk_live_...
Path parameters1
| Name | Type | Required | Notes |
|---|---|---|---|
| accountId | string | Yes | max 64 chars |
Response · 200
Success
data
| Field | Type | Always present | Notes |
|---|---|---|---|
| object | "email_account" | Yes | |
| id | string | Yes | |
| string | Yes | ||
| display_name | string · nullable | Yes | |
| provider | string | Yes | |
| status | string | Yes | |
| last_checked_at | string · nullable | Yes | |
| created_at | string | Yes | |
| updated_at | string | Yes |
meta
| Field | Type | Always present | Notes |
|---|---|---|---|
| request_id | string | Yes |