Email

Add a sender

Creates a sender. A sender on a domain takes the domain's namespace, and a namespaceId that names another namespace is refused; a sender with no domain joins namespaceId, or its key's namespace. A namespace-scoped key cannot add a sender on a domain outside its namespace. The required Idempotency-Key replays the original sender for an identical request and conflicts when reused with different input.

post/v1/email/senders

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/email/senders
  • Auth: API key in header x-api-key

Headers

idempotency-keystring required

Request body

emailstring required
domainIdstring
namestring nullable
replyToEmailsstring[] nullable
namespaceIdstring

Response

Success

idstring required
emailstring required
status'pending' | 'verified' | 'failed' required
providerLifecycle'provisioning' | 'active' | 'deleting' | 'failed' required
providerFailureCodestring nullable required
createdAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.