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": "[email protected]",
"name": "Your Name"
},
"to": [{
"email": "[email protected]",
"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": "[email protected]",
"name": "Your Company"
},
"to": [{
"email": "[email protected]",
"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.
Response
Success Response (HTTP 200):
[
{
"messageId": "abc123-def456-ghi789",
"errorCode": 0,
"to": "[email protected]"
}
]
Next Steps