Skip to content
User guide

Webhooks: connecting your platform to Zapier, Make and your own systems

Yarbah sends a signed JSON message to your endpoint on every purchase, customer, refund or subscription, with retries, pausing and signature checks.

What are webhooks?

On every purchase, new customer, refund or subscription, Yarbah sends a JSON message to a URL you choose. Use them to connect your platform to tools like Zapier, Make and n8n, or your own system, to add buyers to an email list, a sheet or another CRM. They're on the Business plan.

Who can use it?

Available on: Business, and as an add-on for Pro from the app store. Up to 5 endpoints per platform.

Add an endpoint

  1. From the menu, open Webhooks.
  2. Paste the endpoint URL (starting with https://), such as a Zapier "Catch Hook" URL.
  3. Pick the events, then click Add endpoint.
  4. Copy the signing secret right away; it won't be shown again.
  5. Click Send test and check that the event arrived in the log.

Events

  • purchase.completed: a paid order, with its number, the customer, the products and the amounts.
  • customer.created: a new customer's first purchase.
  • refund.completed: a refund that went through.
  • subscription.started and subscription.ended: a membership, subscription or installment plan starts or ends.

Amounts are integers in the currency's smallest unit (100 = 1.00).

Verify the signature

Every request has the Yarbah-Signature header as t=timestamp,v1=signature. The signature is HMAC-SHA256 of "timestamp.body" with the signing secret. Compute it in your system and compare, and reject the request if it differs or is older than 5 minutes. The Yarbah-Delivery header is a unique id per event; use it to ignore repeats.

When delivery fails

Your endpoint must answer 2xx within 10 seconds. Otherwise the event is retried up to 8 times, with gaps growing from a minute to a day. After 20 failed events in a row the endpoint is paused automatically; switch it back on from the Webhooks page once fixed. The log shows the last 50 events and the state of each.

Security

If you think the signing secret leaked, click New secret; the old one stops at once. Webhooks are never sent to yarbah.com or internal addresses.

FAQs about this page

Updated 19 November 2026

Was this article helpful?