Send a message

post/mailboxes/{mailbox}/send

Send plain-text mail from a mailbox. If this key may only send with approval, the message is held and the result says waiting_for_approval; check send_status later. Never assume a held message was delivered.

Before you call

Credential: Authorization: Bearer $KEY

Parameters

mailboxstringrequired
In the path. Mailbox address.

Request bodyapplication/json, required

tolist of string
subjectstring
textstring

Responses

200application/json
Send a message
- statusstringrequired
  One of: sent, waiting_for_approval.
- idstring or null
- notestring
401
No valid access key.
403
The key may not do this on this mailbox.
429
Too many calls; see Retry-After.

Example request

curl -X POST 'https://email.inbox.praecise.com/api/mailboxes/{mailbox}/send' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "to": [
    "string"
  ],
  "subject": "string",
  "text": "string"
}'

$KEY stands for your own key. No key is shown or kept on this site.

This page as Markdown