Send a message with the Email API

curl --request POST \
  --url https://api.paubox.com/v1/email/messages \
  --header 'Authorization: Bearer <token>' \
  --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"
}

{
  "errors": [
    {
      "code": 123,
      "title": "<string>",
      "details": "<string>"
    }
  ]
}

POST

messages

curl --request POST \
  --url https://api.paubox.com/v1/email/messages \
  --header 'Authorization: Bearer <token>' \
  --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"
}

{
  "errors": [
    {
      "code": 123,
      "title": "<string>",
      "details": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Paubox API uses Bearer token authentication in the Authorization header.

Format: Authorization: Bearer YOUR_API_KEY_HERE

Example: Authorization: Bearer 9e5b092b632445b8f570c62ae54f30fda1044305

The legacy format Authorization: Token token=YOUR_API_KEY_HERE is also supported.

Body

application/json

data

object

required

Show child attributes

Response

Message accepted

sourceTrackingId

string

Identifier for tracking the message source.

customHeaders

object

Show child attributes

data

string

Example:

"Service OK"

⌘I

Email API · Messages

Email API · Scheduled Send

Email API · Receiving

Email API · Webhooks

Email API · Dynamic templates

Marketing · Campaigns

Marketing · Drip campaigns

Marketing · Subscribers

Marketing · Subscriptions

Marketing · Subscription lists

Marketing · Tracking links

Marketing · Analytics

Forms API

Send a message with the Email API

Authorizations

Body

Response