Webhooks
What you'll achieve: Get notified when a new lead is captured. Webhooks are available on Starter and Growth plans. Configure a URL in project settings; we send a POST with the lead payload and a signature for verification.
Event: lead.created
When a lead is created, we POST to your webhook URL with a JSON body containing the lead data (id, name, email, phone, attributes, source_url, created_at, etc.).
Signature verification
We include a X-SwiftCRM-Signature header (or similar) so you can verify the request came from SwiftCRM. Use the webhook secret from your project settings and HMAC to validate the payload. See the in-app webhook settings for the exact header name and algorithm.
Best practices
- Respond with 2xx quickly so we don't retry unnecessarily.
- Verify the signature before processing.
- Add your endpoint in project settings → Webhooks.