Skip to main content
POST
/
messages
curl --request POST \
  --url https://api.paubox.net/v1/{api_username}/messages \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "message": {
      "recipients": [
        "recipient@host.com"
      ],
      "headers": {
        "subject": "Hello from the Paubox Email API",
        "from": "sender@verifieddomain.com"
      },
      "content": {
        "text/plain": "Hello world",
        "text/html": "<html><body><h1>Hello world</h1></body></html>"
      }
    }
  }
}
'
{
  "sourceTrackingId": "3d38ab13-0af8-4028-bd45-52e882e0d584",
  "customHeaders": {
    "X-Custom-Header": "value"
  },
  "data": "Service OK"
}

Documentation Index

Fetch the complete documentation index at: https://docs.paubox.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Paubox API uses a custom token format in the Authorization header.

IMPORTANT: You must prefix your API key with "Token token="

Format: Authorization: Token token=YOUR_API_KEY_HERE

Example: Authorization: Token token=9e5b092b632445b8f570c62ae54f30fda1044305

Do NOT use just the API key alone or Bearer token format.

Body

application/json
​
data
object
required

Response

Message accepted

​
sourceTrackingId
string

Identifier for tracking the message source.

​
customHeaders
object
​
data
string
Example:

"Service OK"