Mailneo
|Docs

Email Accounts

Accounts API

2 endpoints under https://api.mailneo.co/api/v2. Every request carries your key in the x-api-key header.

Scope used on this page: accounts:read. Each endpoint below states the one it requires. Start with the quickstart →

GET/accounts

List connected sending accounts

Requires accounts:read

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.

Query parameters7
limitintegerdefault: 251..100
cursorstring≤ 256 chars
Opaque page cursor from a previous response’s next_cursor. Treat it as a black box: cursors are bound to the sort they were issued under and are validated strictly, so a hand-crafted, modified or foreign cursor — including any cursor issued before the 2026-08 format revision — answers 400 cursor_invalid. On that error, restart from the first page.
order"asc" | "desc"default: desc
updated_sincestring · date-time
sort"updated_at" | "created_at"default: updated_at
status"PENDING" | "ACTIVE" | "ERROR" | "SUSPENDED" | "REVOKED"
provider"GMAIL" | "GOOGLE_WORKSPACE" | "OUTLOOK" | "MICROSOFT" | "SMTP_AMAZON_SES" | "SMTP_SENDGRID" | "SMTP_MAILGUN" | "SMTP_BREVO" | …
curl "https://api.mailneo.co/api/v2/accounts?limit=25&order=desc&sort=updated_at" \
  -H "x-api-key: $MAILNEO_API_KEY"
{
  "data": [
    {
      "object": "email_account",
      "id": "c13jh9k1139hnv212zi26312p",
      "email": "ada@example.com",
      "display_name": "Ada Lovelace",
      "provider": "…",
      "status": "PENDING",
      "last_checked_at": "2026-06-24T15:45:00.000Z",
      "created_at": "2026-05-11T09:30:00.000Z",
      "updated_at": "2026-06-24T15:45:00.000Z"
    }
  ],
  "meta": {
    "request_id": "ad9150b7-ac91-4f24-af91-53ddae91524a",
    "has_more": false,
    "next_cursor": null,
    "synced_through": "2026-06-24T15:45:00.000Z"
  }
}
GET/accounts/{accountId}

Retrieve a sending account

Requires accounts:read

Metadata only. No credential field is returned under any parameter.

Path parameters1
accountIdstringrequired1..64 chars
curl "https://api.mailneo.co/api/v2/accounts/{accountId}" \
  -H "x-api-key: $MAILNEO_API_KEY"
{
  "data": {
    "object": "email_account",
    "id": "c13jh9k1139hnv212zi26312p",
    "email": "ada@example.com",
    "display_name": "Ada Lovelace",
    "provider": "…",
    "status": "PENDING",
    "last_checked_at": "2026-06-24T15:45:00.000Z",
    "created_at": "2026-05-11T09:30:00.000Z",
    "updated_at": "2026-06-24T15:45:00.000Z"
  },
  "meta": {
    "request_id": "b7380e00-b838-4f93-a938-1126ba3812b9"
  }
}