How do I register a webhook endpoint?

Create the endpoint from the API or in Settings, then Developer, give it your URL, and choose the events to subscribe to. Mercateer returns a signing secret you use to verify deliveries, and you can update or remove the endpoint at any time.

What events can I subscribe to?

New lead captured, contact created, conversation started, conversation handoff requested, conversation closed, call completed, missed call, appointment booked, appointment rescheduled, and quote accepted. Subscribe to all of them or only the ones you need.

How do I verify a delivery came from Mercateer?

Every payload is signed with HMAC-SHA256 using your endpoint secret. Read the timestamp and signature from the signature header, compute the HMAC of "{timestamp}.{raw request body}", and compare it to the signature value, dropping the request if it does not match or if the timestamp is over 5 minutes old. That way a forged or replayed call can never trigger your handler. Our SDK ships a verify helper so you don’t have to implement this by hand.

What happens when my endpoint is down?

Failed deliveries retry with backoff for a window, so a brief outage does not lose events. Make your handler idempotent by keying on the event ID, since a retried delivery can arrive more than once.

Which Mercateer plan do I need?

Webhooks are part of API access, which is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to register endpoints.

Developer

Get Mercateer front-office events as webhooks

Subscribe an endpoint to Mercateer events and receive a signed payload the moment a call wraps, a lead comes in, or a job is booked. Register and manage endpoints from the API or dashboard, and verify every delivery with HMAC.

Install in minutes All integrations

What is Webhooks?

Webhooks push Mercateer front-office events to a URL you control in real time, so your own systems can react without polling the API. Each delivery is a JSON payload signed with HMAC, you register and manage endpoints from the API or dashboard, and failed deliveries retry with backoff.

What you can do with Webhooks

New lead captured and contact created

Conversation started, closed, or handoff requested

Call completed

Appointment booked and appointment rescheduled

Quote accepted

HMAC-signed payloads you verify on receipt

Install in minutes

Create an endpoint

Register your URL and pick the events to subscribe to, from the API or in Settings, then Developer. Mercateer returns a signing secret for that endpoint. API access is included on the Crew and Fleet plans.

Verify the signature

On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}.{raw request body}" with your signing secret and compare it to the v1 value. Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer. (Our SDK’s verify helper does all of this for you.)

Handle retries idempotently

Respond 2xx quickly to acknowledge a delivery. Failed deliveries retry with backoff, so key your handler on the event ID to ignore duplicates and process each event once.

Frequently asked questions

Works with your whole stack

Mercateer speaks the same protocols as the tools you already use.

Claude Desktop Claude Code Claude Cowork ChatGPT Cursor Codex Zapier n8n Make.com

See all integrations

Put Mercateer to work with Webhooks

Start free and connect your front office in minutes.

Start free

No credit card required