Newsletter domains

Newsletter domains are the verified sending identities used by newsletter drafts. List them before creating a newsletter so you can pass the correct newsletter_domain_id.

Last updated July 4, 2026

List newsletter domains

GET /v1/newsletter-domains

Scope: newsletters:read. Supports cursor and limit pagination.

{
  "data": [
    {
      "object": "newsletter_domain",
      "id": "nwsdom_abc123",
      "root_domain_id": "dom_abc123",
      "domain_name": "updates.example.com",
      "from_local_part": "updates",
      "from_address": "updates@updates.example.com",
      "mail_from_domain": "mail.updates.example.com",
      "reply_to_mailbox_id": "mbx_abc123",
      "status": "verified",
      "dkim_status": "verified",
      "mail_from_status": "verified",
      "spf_status": "verified",
      "dmarc_status": "verified",
      "verified_at": "2026-07-04T12:00:00.000Z",
      "created_at": "2026-07-04T12:00:00.000Z",
      "updated_at": "2026-07-04T12:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 25
  }
}

Use with newsletters

const domains = await shipmail.newsletters.domains.list({ limit: 25 });

const newsletter = await shipmail.newsletters.create({
  audience_id: "aud_abc123",
  newsletter_domain_id: domains.data[0].id,
  name: "July changelog",
  subject: "What shipped in July",
  body_html: "<h1>July updates</h1><p>...</p>",
});