Emails
Send a single email
Queue a single email for delivery. Returns immediately with a queued or scheduled status.
Requires email:send scope.
Supports idempotency via the X-Idempotency-Key header — duplicate requests within 24h
return the original response.
Either html or text body is required. Total recipients (to + cc + bcc) cannot exceed 50.
POST
Authorizations
API key authentication. Pass your Gorillaa Mail API key as a Bearer token.
Example: Authorization: Bearer grl_live_xxxxxxxxxxxx
Keys prefixed grl_test_ operate in test mode with reduced limits.
Headers
Unique idempotency key (max 255 chars). Duplicate requests within 24h return the original response.
Maximum string length:
255Body
application/json
An email address — either a plain string or an object with name
Example:
Primary recipients (1–50)
Required array length:
1 - 50 elementsAn email address — either a plain string or an object with name
Example:
Required string length:
1 - 998Maximum array length:
50An email address — either a plain string or an object with name
Example:
Maximum array length:
50An email address — either a plain string or an object with name
Example:
An email address — either a plain string or an object with name
Example:
HTML body (max 5MB). Either html or text is required.
Maximum string length:
5242880Plain text body (max 1MB). Either html or text is required.
Maximum string length:
1048576Custom email headers
Tags for categorization (max 10)
Maximum array length:
10Maximum string length:
100Schedule delivery for a future time (must be ≥1 minute in the future)
Client-generated idempotency key
Maximum string length:
255File attachments (max 10)
Maximum array length:
10Arbitrary metadata stored with the email
Response
Email accepted for delivery