Mailactor
API reference

Submit a message

Required scope: delivery:send.

POST/v1/send

Authorization

tenantApiKey
x-api-key<token>

A scoped tenant key returned once by an operator. Never place it in URLs, logs, prompts, or client-side application code.

In: header

Header Parameters

idempotency-key*string
Match^[A-Za-z0-9._:-]+$
Length8 <= length <= 200

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

# Set the API key and replace resource IDs with your saved IDs.# Generate once per logical action; preserve this key for retries.export IDEMPOTENCY_KEY="request-$(uuidgen)"curl --fail-with-body --silent --show-error -X POST \  "https://api.mailactor.com/v1/send" \  -H "x-api-key: $MAILACTOR_API_KEY" \  -H "idempotency-key: $IDEMPOTENCY_KEY" \  -H "Content-Type: application/json" \  -d '{  "from": {    "email": "agent@agents.example.com"  },  "to": [    {      "email": "you@example.com"    }  ],  "subject": "Hello from Mailactor",  "text": "A message from my verified domain."}'