Create a key to copy examples filled with your team.

Managing domains

Create, verify, suspend, and resume sending domains.

Create, show, list, verify, suspend, resume, and make primary from the dashboard or the API. The public API cannot delete a domain, and the current dashboard page does not show a delete control. The first created domain is the account primary. Make primary on another verified domain to move it.

API

Method Path
GET /api/v1/teams/:team_id/sending_domains
POST /api/v1/teams/:team_id/sending_domains
GET /api/v1/sending_domains/:id
POST /api/v1/sending_domains/:id/verify
POST /api/v1/sending_domains/:id/suspend
POST /api/v1/sending_domains/:id/resume
POST /api/v1/sending_domains/:id/make_primary

Create

name is required. dkim_selector defaults to s1. tenant_id defaults to the team's default tenant. Create and verify both queue a DNS check.

domain.json
1 {
2 "sending_domain": {
3 "name": "mail.example.com",
4 "dkim_selector": "s1",
5 "tenant_id": 12
6 }
7 }
  1. Publish the DKIM CNAME and the rp.{name} CNAME.
  2. Call verify, or wait for the queued check.
  3. Send from that host once dkim_status and return_path_status are verified.

Suspend pauses sending for that domain. Resume turns it back on. The CNAME hosts stay on the domain either way. Make primary moves the second DKIM signature to this domain. The domain must be verified and not suspended.

About

PostShiba is the transactional email platform that powers Bento behind the scenes. You can build your own products, like Bento, on top of it.

© 2026 PostShiba by Backpack Internet Pty. Ltd. All rights reserved.

The same policies that govern Bento are applied to PostShiba Privacy | Terms | Security