Domains

List mailbox domains

Changed on

Returns a cursor-paginated list of sending domains configured for the team, ordered by created_at descending. Each entry includes the DNS records the customer must place, the current verification status, and the SES DKIM state. Pass cursor=<next_cursor> from the previous response to fetch the next page.

get/domains

Request

  • Base URL: https://app.sendmux.ai/api/v1
  • URL: https://app.sendmux.ai/api/v1/domains
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.sendmux.ai/oauth/authorize, token URL https://app.sendmux.ai/oauth/token, scopes: domain.read)

Query parameters

cursorstring

Pagination cursor — the next_cursor from the previous response.

limitinteger

Maximum results (default 50, max 100)

Response

Domain list

oktrue required

Example response

{
  "meta": {
    "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "data": [
    {
      "dns_records": {
        "dkim": [
          {
            "name": "_sendmux.acme.com",
            "value": "sendmux-verify=team_abc123"
          }
        ],
        "dmarc": {
          "name": "_sendmux.acme.com",
          "value": "sendmux-verify=team_abc123"
        },
        "mail_from": {
          "mx": {
            "name": "bounce.acme.com",
            "priority": 10,
            "target": "feedback-smtp.eu-central-1.amazonses.com"
          },
          "spf": {
            "name": "_sendmux.acme.com",
            "value": "sendmux-verify=team_abc123"
          }
        },
        "mx": [
          {
            "priority": 10,
            "target": "mail.sendmux.ai"
          }
        ],
        "spf": {
          "name": "_sendmux.acme.com",
          "value": "sendmux-verify=team_abc123"
        },
        "verification": {
          "name": "_sendmux.acme.com",
          "value": "sendmux-verify=team_abc123"
        }
      },
      "domain": "mail.acme.com",
      "id": "mdom_clxxxxxxxxxxxxxxxxxxxxxxxxx",
      "mailbox_count": 14,
      "mode": "send_receive"
    }
  ]
}

Changes

  • 7807ce923952Revision changes
    • info

      the endpoint scheme security oauth2 was added to the API

  • a53e49562216Revision changes
    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status