Application modules

If you work with a CRM, your clinic software or tools such as Zapier or n8n, Markettai can send them each new lead as soon as it arrives, so you do not have to copy it by hand from Clients. It is included in the Pro, Master and Agency plans, and the account owner or an admin sets it up.

How to connect it.

  1. In your tool, create a "webhook" (in Zapier it is called "Catch Hook"; in n8n, the "Webhook" node). It gives you a URL that starts with `https://`.
  2. In Markettai, go to My account › Connections, or click "Connect your CRM" in Clients. In the "Send your leads to your CRM" card, paste the URL, give it a name if you like and click "Connect".
  3. We show you a secret that starts with `whsec_`. Copy it and save it in your tool: you will not see it again. If you lose it, click "New secret": the old one stops working at once, so we ask you to confirm, and deliveries that arrive before you put the new one in will be retried.
  4. Click "Test". A test lead with made-up details reaches your tool, so you can build the rest of your flow. You can run up to ten tests per hour.

You can have up to three destinations. The URL cannot be edited: to change it, delete the destination and create another.

What your tool receives. One message per new lead, with these fields:

Field
`event`
What it is
Always "lead.created"
Example
`lead.created`
Field
`delivery_id`
What it is
Identifier of the delivery
Example
`7c1e4b2a-…`
Field
`test`
What it is
Whether it is a test
Example
`false`
Field
`lead.id`
What it is
Identifier of the lead in Markettai
Example
`b5a2…`
Field
`lead.created_at`
What it is
When it arrived, in UTC
Example
`2026-10-13T09:30:05+00:00`
Field
`lead.name`
What it is
Name
Example
`Ana López`
Field
`lead.email`
What it is
Email
Example
`ana@example.com`
Field
`lead.phone`
What it is
Phone
Example
`+34600111222`
Field
`lead.origin`
What it is
Where it came from: your page or a Meta form
Example
`landing` or `meta_ads`
Field
`lead.landing`
What it is
The page they left it on: identifier, name and address
Example
`https://yourclinic.mkti.live`

A field the customer did not fill in arrives empty (`null`). The free answers of the form are not sent (for example, the reason for the visit): only the contact details and the source. Only the creation of the lead is sent; later changes, such as a confirmed appointment, are not.

How to check that a delivery comes from Markettai. Each delivery carries the `X-Markettai-Signature` header in the form `sha256=…` and the `X-Markettai-Timestamp` header with the time it was sent. If your tool allows it:

  1. Join the value of `X-Markettai-Timestamp`, a dot and the message body exactly as it arrives, untouched.
  2. Compute the HMAC-SHA256 of that text with your secret.
  3. Compare it with what follows `sha256=`. If it does not match, discard the message.
  4. Also reject a message whose time is more than 5 minutes off yours.
  5. If you get an `X-Markettai-Delivery` you had already received, ignore it: it is a resend of the same lead.

If your tool does not answer. We try again after 5 minutes, 15 minutes, 1 hour, 3 hours, 6 hours and 10 hours. The card shows the latest deliveries of each destination, with their status and the code your tool answered. If a destination has been failing for three days in a row, without a single good delivery and without a successful "Test" from you, we disable it and tell you on the card: check your tool and click "Activate". Meanwhile, your leads are still in Clients.

If you change plan. If you move to a plan without this feature, your destinations are kept but nothing is sent; you can pause or delete them.

Who answers for the data. You choose the destination, and you answer for what that tool does with your customers' data. Check that your tool meets data protection rules just like your own practice.

Something not working? See «How to tell where the problem is».

NextPlans and advertising spend limits