Once your SparkPost provider and IP Pool are configured, you can send emails through SparkPost using the standard SendPost API.
Important: You must include the ippool parameter in your API request to route emails through SparkPost.
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 SparkPost",
"htmlBody": "<h1>Hello!</h1><p>This email is sent through SparkPost.</p>",
"textBody": "Hello! This email is sent through SparkPost.",
"ippool": "sparkpost-pool",
"trackOpens": true,
"trackClicks": true
}'
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": "sparkpost-pool",
"trackOpens": true,
"trackClicks": true
}'
Response
Success Response (HTTP 200):
[
{
"messageId": "abc123-def456-ghi789",
"errorCode": 0,
"to": "[email protected]"
}
]
Next Steps
