Common Issues
Emails Not Sending
Emails Not Sending
Symptoms: Emails are not being delivered through SparkPostChecklist:If this returns 401, your API key is invalid.
- Verify your SparkPost API key is valid and has Transmissions permissions
- Check that the TPSP is active in SendPost
- Review the SendPost event logs for errors
- Confirm your SparkPost account is in good standing
- Verify your sending domain is properly configured in SparkPost
Events Not Appearing
Events Not Appearing
Symptoms: Emails are sent but opens/clicks/bounces not showingChecklist:
- Verify webhook is registered in SparkPost Dashboard
- Check webhook URL is correct
- Ensure webhook events are enabled
- Wait a few minutes (events are batched for processing)
- Go to SparkPost → Configuration → Webhooks
- Confirm URL shows:
https://api.sendpost.io/tpsp/sparkpost/account/{account-id} - Verify all event checkboxes are enabled
Bounces Not Processing
Bounces Not Processing
Symptoms: Bounced emails not reflected in analyticsCheck:
- Review bounce class in event details
- Hard bounces (class 10, 30, 50-52) = permanent failures
- Soft bounces (class 20-25, 70) = temporary failures
- Ensure bounce events are enabled in webhook settings
API Key Errors
API Key Errors
| Error Code | Meaning | Solution |
|---|---|---|
| 401 | Invalid API key | Regenerate API key in SparkPost |
| 403 | Insufficient permissions | Update API key permissions (needs Transmissions + Webhooks) |
| 429 | Rate limit exceeded | Wait and retry, or increase limits |
| 400 | Bad Request | Check payload format and required fields |
Getting Help
If you’re still experiencing issues:- Check Logs: Review detailed event logs in SendPost dashboard
- Contact Support: Reach out to SendPost support with:
- Your account ID
- TPSP ID
- Message ID (if available)
- Error messages
- Timestamp of the issue
FAQs
Can I use multiple SparkPost accounts?
Can I use multiple SparkPost accounts?
Yes! Create a separate TPSP for each SparkPost account. Each will have its own webhook and configuration.
Does SendPost store my SparkPost API key securely?
Does SendPost store my SparkPost API key securely?
Yes, all API keys are encrypted at rest and never exposed in logs or API responses.
Can I use SparkPost for some emails and SendPost IPs for others?
Can I use SparkPost for some emails and SendPost IPs for others?
Yes, SendPost supports intelligent routing. You can configure rules to route specific traffic through SparkPost.
What SparkPost regions are supported?
What SparkPost regions are supported?
SendPost uses the SparkPost US endpoint (
api.sparkpost.com). If you use SparkPost EU, contact support for configuration assistance.What happens if the webhook endpoint is temporarily unavailable?
What happens if the webhook endpoint is temporarily unavailable?
Are duplicate events possible?
Are duplicate events possible?
SparkPost may occasionally send duplicate events. SendPost handles deduplication using the SparkPost message ID.
What's the difference between open and initial_open events?
What's the difference between open and initial_open events?
initial_open is the first time a recipient opens an email. open events may include subsequent opens. Both are mapped to the SP Opened event type (ID: 43).What's the latency for event processing?
What's the latency for event processing?
Events are typically processed within 1-5 seconds of being received from SparkPost.
Is there a limit on emails per day?
Is there a limit on emails per day?
SendPost doesn’t impose hard limits, but your SparkPost plan limits still apply. Configure throttling to match your SparkPost limits.
How does SparkPost handle delay events?
How does SparkPost handle delay events?
Delay events indicate temporary delivery issues. SparkPost will automatically retry. These events are tracked but not counted as failures.