Skip to content
English
  • There are no suggestions because the search field is empty.

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:

  1. 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.
  2. 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

  1. Open the campaign and turn on Webhook source (it generates a unique, immutable URL, visible in the editor).
  2. Copy the URL. Treat it like a password: do not put it in public code on your site.
  3. From your form, send a POST in JSON format with at least name and email. 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.
  4. 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).
  5. New contacts enter the scoring process and follow the campaign rules.

Create an Outbound Webhook

  1. In Integrations › Outbound Webhooks click New webhook.
  2. Complete Name, Destination URL, an optional description and, if you need it, Custom headers (Add header).
  3. In Events check at least one (grouped into Leads, Notes and meetings, Calls, LinkedIn, Email and WhatsApp).
  4. Leave Active webhook on and click Send test (it requires the webhook to be active): you will see "Sent successfully (HTTP 200)" or "Failed".
  5. 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

SymptomCommon causeWhat to checkWhen to escalate
The form receives 403Webhook disabled, campaign not active or incorrect URLTurn on the Webhook source, activate the campaign and copy the URL againIf everything is active
Response 400name or email missingCheck the JSON format—
Response 429More than 100 requests per minuteSlow downIf you need more volume
Leads arrive but do not enter the sequenceThe campaign's minimum ICP score or campaign rulesCheck "Minimum ICP Score"If you cannot find the cause
Outbound webhook "Failed" or "Dead"Your server responded with an error or did not respondCheck the HTTP code in the log; fix your endpoint and click RetryIf your endpoint works and it still fails
"Maximum of 10 webhooks reached."Per-company limitDelete one—
"The webhook must be active to test it"It is inactiveTurn 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.