Skip to main content
Once your Amazon SES provider is configured and identities are set up, you can send emails through Amazon SES using the standard SendPost API.
Important: You must include the ippool parameter in your API request to route emails through Amazon SES. Use the IP Pool that was automatically created for your SES integration.

​
Basic Email Example

curl -X POST "https://api.sendpost.io/api/v1/subaccount/email/" \
  -H "X-SubAccount-ApiKey: YOUR_SENDPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "sender@yourdomain.com",
      "name": "Your Name"
    },
    "to": [{
      "email": "recipient@example.com",
      "name": "Recipient Name"
    }],
    "subject": "Hello from SendPost via Amazon SES",
    "htmlBody": "<h1>Hello!</h1><p>This email is sent through Amazon SES.</p>",
    "textBody": "Hello! This email is sent through Amazon SES.",
    "ippool": "ses-pool"
  }'

​
Email with Personalization

curl -X POST "https://api.sendpost.io/api/v1/subaccount/email/" \
  -H "X-SubAccount-ApiKey: YOUR_SENDPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "sender@yourdomain.com",
      "name": "Your Company"
    },
    "to": [{
      "email": "john@example.com",
      "name": "John Doe",
      "customFields": {
        "firstName": "John",
        "accountType": "Premium"
      }
    }],
    "subject": "Welcome {{firstName}}!",
    "htmlBody": "<h1>Welcome {{firstName}}!</h1><p>Your {{accountType}} account is ready.</p>",
    "ippool": "ses-pool"
  }'
Automatic Tracking: Open and click tracking are automatically enabled in the configuration set. You don’t need to include trackOpens or trackClicks parameters in your API requests.
Domain Verification: If you’re routing emails only through Amazon SES (no SendPost IPs in your IP Pool), you don’t need to verify your domain in SendPost. Your domain only needs to be verified in Amazon SES. However, if your IP Pool includes SendPost IPs alongside SES, the domain must be verified in both.

​
Response

Success Response (HTTP 200): 
[
  {
    "messageId": "abc123-def456-ghi789",
    "errorCode": 0,
    "to": "recipient@example.com"
  }
]

​
Next Steps