Send leads to your CRM
Post each new lead to your own HTTPS endpoint with a signed webhook, and get a daily count by email.
Updated 2026-11-17
You can have each new lead posted as JSON to your own endpoint, and get a daily email with the number of new leads. Both are set on the Leads page.
Before you start
- You have an endpoint on a public
https://address that accepts a POST. - You have a signing secret of at least 16 characters. Keep it on your server.
- To save these settings, you need the Owner, Admin or Manager permission.
For agencies
Choose the client under Advertiser first. Each client has its own settings.
Steps
- Open Leads and scroll to Send leads to your CRM.
- Enter your Webhook URL and Signing secret.
- Tick Post each new lead.
- To get a daily email, tick Email me a daily count.
- Select Save.
- Select Send a test lead. The page tells you what your endpoint answered.
A test lead is marked "test": true and nothing is stored.
Send some orders' leads somewhere else
If you run campaigns for several clients, each client's leads can go to its own CRM. Add a lead destination for each one.
- On the Leads page, under Lead destinations, select Add a destination.
- Give it a name, a Webhook URL and a Signing secret of at least 16 characters.
- Tick the orders whose leads should go there.
- Select Save, then Send test.
Leads from the orders you picked go only to that destination. Leads from every other order go to the webhook above. An order can be in one destination only.
If you switch a destination off, its orders' leads stay in the list and CSV but aren't posted anywhere. If you delete one, its orders' leads go to the webhook above again. Leads still waiting to be sent go there too.
The Delivery column shows which destination a lead was sent to.
What happens next
Each new lead is posted shortly after it arrives. Your endpoint should answer with a 2xx status within 10 seconds. Redirects aren't followed.
A failed post is tried up to 5 times in all, over about two and a half hours. After that the lead shows as failed in the Delivery column, and you can still get it from the list or CSV.
The daily email goes to your advertiser contact address, with the number of new leads. Test leads aren't counted.
Post the outcome back
Your CRM can tell us what became of each lead: good or bad with a reason, and the stage it reached. Use the lead's id from the post with the lead feedback API and an account API key. See rate your leads.
Check the signature
Every request is signed so you can check that it came from MailAdx. Open How to check the signature on the page for the header name, the method and a code sample. Reject requests older than five minutes.
What each post carries
| Field | Contents |
|---|---|
event |
lead.created |
id, createdAt |
The lead's id and time |
kind |
LEAD, SUBSCRIBE or RSVP |
email, fields |
What the reader sent |
rsvp |
The chosen time, on RSVP leads |
doubleOptInRequired |
true on subscribers. Send your own confirmation first |
campaign |
orderId, orderName, lineItemId, lineItemName, creativeId |
advertiser |
id and name of the advertiser account |
publisher |
id, name and website of the newsletter the lead came from |
publisherId |
The same id as publisher.id, kept for endpoints built before |
adUnitId |
The ad slot in that newsletter |
consent |
The consent text, privacy URL and time |
test |
true on test data |
If something goes wrong
- "The webhook must be an https:// URL". Plain
httpisn't accepted. - "Add the webhook URL first". Enter it before you tick Post each new lead.
- "Use a signing secret of at least 16 characters". Use a longer secret.
- "Set a signing secret so you can verify our requests". A webhook can't be switched on without one.
- "Your endpoint answered 500". Your endpoint received the test and failed. Check its logs.
- "Your endpoint did not answer". Check the URL is public and answers within 10 seconds.
- "An order you picked is not in this advertiser's account". Pick only this account's orders.
- "Order … already goes to …". Remove the order from the other destination first.
Related
Still stuck? support@mailadx.com