Sign in
Sending

Get outbound sending readiness

Changed on

The "what can I send From?" bootstrap, the outbound mirror of /inbox/status. Returns per-domain sending readiness for every domain in the caller's org, plus the flat sendable_domains list of From-domains the org may send from right now. That list is the same set echoed in a cannot_send_from_domain error's details, so orienting here before a send and recovering from that error use identical data.

Each domain's status collapses the sending prerequisites into one actionable state: sendable, pending_ownership (ownership TXT not verified), pending_outbound_dns (SPF/DKIM/DMARC not verified), or inactive (domain deactivated). next_actions lists concrete remediation steps, each with a suggested CLI command where one exists.

get/outbound/status

Request

  • Base URL: https://api.primitive.dev/v1
  • URL: https://api.primitive.dev/v1/outbound/status
  • Auth: HTTP bearer

Response

Outbound readiness summary

successboolean required

Changes

  • 52138fa51360Revision changes
    • info

      removed the invalid_signup_code enum value from the / response property for the response status

  • 22d1dfc68434Revision changes
    • warning

      added the new not_a_repeating_send enum value to the / response property for the response status

    • warning

      added the new repeat_idle_requires_internal_recipient enum value to the / response property for the response status

    • warning

      added the new repeat_recipient_external enum value to the / response property for the response status

    • warning

      added the new repeat_stop_not_allowed enum value to the / response property for the response status

    • warning

      added the new repeat_unsupported enum value to the / response property for the response status