Sending email
Send a message
POSThttps://api.temporam.com/v3/messages
| Field | Type | Required | Description |
|---|---|---|---|
| from | string | Yes | An active mailbox you own |
| to | string | Yes | Recipient address |
| subject | string | Yes | Subject |
| text | string | No | Plain-text body |
| html | string | No | HTML body |
| from_name | string | No | Sender display name |
| reply_to_message_id | string | No | Claimed inbound message UUID |
Provide text, html, or both. Sending is not idempotent.
- 1curl -X POST https://api.temporam.com/v3/messages \
- 2 -H "Authorization: Bearer YOUR_API_KEY" \
- 3 -H "Content-Type: application/json" \
- 4 -d '{"from":"[email protected]","to":"[email protected]","subject":"Hello","text":"Hello from Temporam"}'
| Response field | Type | Description |
|---|---|---|
| data.id | string | Outbound message UUID |
| data.from | string | Sender address |
| data.from_name | string | Sender display name, when available |
| data.to | string | Recipient address |
| data.subject | string | Subject |
| data.status | string | Delivery status |
| data.provider_message_id | string | Provider message ID, when available |
| data.created_at | string | Creation time |
| data.sent_at | string | Send time, when available |
| meta.remaining | integer | Remaining outbound quota, when available |
Get delivery details
GEThttps://api.temporam.com/v3/messages/{id}
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string (UUID) | Yes | Outbound message UUID |
| Response field | Type | Description |
|---|---|---|
| data.id | string | Outbound message UUID |
| data.from | string | Sender address |
| data.to | string | Recipient address |
| data.subject | string | Subject |
| data.status | string | Delivery status |
| data.provider_message_id | string | Provider message ID, when available |
| data.created_at | string | Creation time |
| data.sent_at | string | Send time, when available |
| meta.remaining | integer | Remaining outbound quota, when available |
Successful sending consumes outbound quota and is unavailable on the Hobby plan. The lookup response does not include text, html, or from_name.