Webhooks — receive leads from forms and send events to other systems
Lymera offers two types of webhooks:
# Webhooks: receive leads and send events
📘 What it is
Lymera offers two types of webhooks:
- A campaign's Webhook source (inbound): gives you a unique URL so your forms, landing pages or other systems send contacts directly to a campaign.
- Outbound Webhooks: Lymera sends events (lead created, status changed, notes, meetings, calls, LinkedIn messages, emails and WhatsApp) to a URL in your system through HTTP POST.
📍 Where to find it
- Inbound: Campaigns › your campaign › configuration tab › Leads section › Webhook source.
- Outbound: Setup › Integrations › Outbound Webhooks section (up to 10 webhooks per company).
🛠️ How to do it
Receive leads with the Webhook source
- Open the campaign and turn on Webhook source (it generates a unique, immutable URL, visible in the editor).
- Copy the URL. Treat it like a password: do not put it in public code on your site.
- From your form, send a POST in JSON format with at least
nameandemail. Optional fields: last name, phone with country code, company, job title, LinkedIn URL, lead source (for example "Meta Ads"), temperature (COLD, WARM or HOT; COLD by default), context, industry, size, city, country, website and annual revenue. Your technical team can consult the full reference in the webhooks section of the platform documentation. - Responses: 200 with "received" = received; if the contact already existed by email, it is enriched; 400 = name or email missing or the email is not valid; 403 = invalid token, webhook disabled or campaign not active; 429 = too many requests (maximum 100 per minute per campaign).
- New contacts enter the scoring process and follow the campaign rules.
Create an Outbound Webhook
- In Integrations › Outbound Webhooks click New webhook.
- Complete Name, Destination URL, an optional description and, if you need it, Custom headers (Add header).
- In Events check at least one (grouped into Leads, Notes and meetings, Calls, LinkedIn, Email and WhatsApp).
- Leave Active webhook on and click Send test (it requires the webhook to be active): you will see "Sent successfully (HTTP 200)" or "Failed".
- Click Create webhook.
Review and retry deliveries
In the list (columns Name, URL, Status, Last HTTP, Events, Last sent) click View logs to see each attempt with status Pending, Sent, Retrying, Failed or Dead, the HTTP code and the attempts. Use Retry on a failed delivery and Reload logs. You can Edit or Delete the webhook (deleting cannot be undone).
❓ Frequently asked questions
Does the Webhook source URL change? No: it is immutable and exclusive to the campaign.
What happens if I send the same contact twice? If the email already exists in the campaign, missing data is filled in; an immediate resend is marked as a duplicate.
Why is my webhook responding 403? The webhook is disabled, the campaign is not active or the URL token is incorrect.
Can I receive WhatsApp or emails in my system? Yes, with the Outbound Webhooks events "Email sent/received" and "WhatsApp sent/received".
How many outbound webhooks can I have? Up to 10 per company.
Can I see the content Lymera sent? In View logs you see the status and HTTP code of each attempt.
🔧 If something doesn't work
| Symptom | Common cause | What to check | When to escalate |
|---|---|---|---|
| The form receives 403 | Webhook disabled, campaign not active or incorrect URL | Turn on the Webhook source, activate the campaign and copy the URL again | If everything is active |
| Response 400 | name or email missing | Check the JSON format | — |
| Response 429 | More than 100 requests per minute | Slow down | If you need more volume |
| Leads arrive but do not enter the sequence | The campaign's minimum ICP score or campaign rules | Check "Minimum ICP Score" | If you cannot find the cause |
| Outbound webhook "Failed" or "Dead" | Your server responded with an error or did not respond | Check the HTTP code in the log; fix your endpoint and click Retry | If your endpoint works and it still fails |
| "Maximum of 10 webhooks reached." | Per-company limit | Delete one | — |
| "The webhook must be active to test it" | It is inactive | Turn it on | — |
Information to request from the customer: company, campaign, webhook name, destination URL (without tokens), HTTP code, time of the attempt, an example of the body sent (without sensitive data) and a screenshot of the log.