Skip to main content
POST
Request a send approval

Authorizations

Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → Developers → API Keys.

Headers

Idempotency-Key
string

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Maximum string length: 100

Body

application/json

The send to hold for the account owner's approval. send_email takes the same body as POST /v1/sending.

action
enum<string>
required
Available options:
send_email
send
object
required

Response

Approval created

success
boolean
required
data
object
error
string | null