Receive inbound webhook lead data
This guide walks through receive inbound webhook lead data for integrations and lead sync.
Inbound Webhooks are the opposite of our (outbound) webhooks. Instead of KickoffLabs pushing data to your own backend/provider, are responsible for sending data to KickoffLabs.
Creating an Inbound Webhook
Section titled “Creating an Inbound Webhook”To use inbound webhooks, from your campaign dashboard, select Setup > All Settings → Webhooks (To KickoffLabs).
The only required data on this page is the name of the webhook. The name only serves to help you remember which service/etc you intended to use this webhook with. You can optionally choose to add any leads received via the inbound webhook to tag. This is an ideal way to help track which leads not only came from this specific source, but to also (optionally) assign additional points (tags can award specific points one or more times). Once you click save, KickoffLabs will generate a unique url for you to use to add new leads to your campaign.
Sending Leads to Your Inbound Webhook
Section titled “Sending Leads to Your Inbound Webhook”- Only support HTTP verb is POST.
- Data be via form parameters or as JSON
- You must include a field named email or phone_number
- All other KickoffLabs API parameters supported by this integration can be mapped from the source system. Use Advanced API workflows and the Developer & API overview when you need a more technical implementation path.
Use Cases
Section titled “Use Cases”The most typical use case for inbound webhooks will be sending leads from other system and capture tools into your KickoffLabs campaign. You will typically need to use a service like Zapier to transform the data from your third party resource (example: MailChimp) into the format KickoffLabs expects.
What to check after
Section titled “What to check after”- Confirm the setting, export, integration, or message changed where you expected in KickoffLabs.
- If this affects leads, forms, referrals, emails, or integrations, submit a fresh test lead and verify the result end-to-end.
- Save the campaign URL, test lead email, screenshots, and any error messages before contacting support.
Need help? Email support@kickofflabs.com. Include your campaign URL, the test lead email, what you expected to happen, and a screenshot or short screen recording.