Setup Instructions
Follow these steps to configure bounce handling for SparkPost.
Step 1: Get Your Webhook URL
- Go to QuillCRM → Settings → SMTP → Bounce Handling
- Find the SparkPost section
- Copy the webhook URL provided
Your webhook URL will look like:
https://yoursite.com/?quillcrm_webhook=bounce&provider=sparkpost&key=your_security_keyStep 2: Configure SparkPost Webhook
- Log in to your SparkPost Dashboard
- Go to Webhooks
- Click Create Webhook
- Enter a name for the webhook (e.g., “QuillCRM Bounces”)
- Paste your QuillCRM webhook URL in the Target URL field
- Under Events, select:
- Bounce
- Out of Band
- Click Create Webhook
Bounce Classification
SparkPost uses numeric bounce class codes. QuillCRM maps these as follows:
| Bounce Class | Description | QuillCRM Classification |
|---|---|---|
| 10 | Invalid Recipient | Hard bounce |
| 25 | Admin Failure | Hard bounce |
| 30 | Generic Bounce (No RCPT) | Hard bounce |
| 90 | Unsubscribe | Hard bounce |
| Other classes | Various transient issues | Soft bounce |
Troubleshooting
- No bounces recorded: Ensure “Bounce” and “Out of Band” event types are selected in your SparkPost webhook configuration.
- 403 Forbidden: The security key may be wrong. Copy the URL again from QuillCRM settings.