Sending email

Send a message

POSThttps://api.temporam.com/v3/messages

FieldTypeRequiredDescription
fromstringYesAn active mailbox you own
tostringYesRecipient address
subjectstringYesSubject
textstringNoPlain-text body
htmlstringNoHTML body
from_namestringNoSender display name
reply_to_message_idstringNoClaimed inbound message UUID

Provide text, html, or both. Sending is not idempotent.

  1. 1curl -X POST https://api.temporam.com/v3/messages \
  2. 2 -H "Authorization: Bearer YOUR_API_KEY" \
  3. 3 -H "Content-Type: application/json" \
  4. 4 -d '{"from":"[email protected]","to":"[email protected]","subject":"Hello","text":"Hello from Temporam"}'
Response fieldTypeDescription
data.idstringOutbound message UUID
data.fromstringSender address
data.from_namestringSender display name, when available
data.tostringRecipient address
data.subjectstringSubject
data.statusstringDelivery status
data.provider_message_idstringProvider message ID, when available
data.created_atstringCreation time
data.sent_atstringSend time, when available
meta.remainingintegerRemaining outbound quota, when available

Get delivery details

GEThttps://api.temporam.com/v3/messages/{id}

ParameterLocationTypeRequiredDescription
idpathstring (UUID)YesOutbound message UUID
Response fieldTypeDescription
data.idstringOutbound message UUID
data.fromstringSender address
data.tostringRecipient address
data.subjectstringSubject
data.statusstringDelivery status
data.provider_message_idstringProvider message ID, when available
data.created_atstringCreation time
data.sent_atstringSend time, when available
meta.remainingintegerRemaining 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.