Send orders to your server with webhooks

A webhook sends an order to your own server when something happens in your store, so your system can act on it. Webhooks come with the Premium plan.

The four addresses

You can set one address for each event. Leave the ones you don't need empty.

Set them up

1. In your admin, go to Integrations → Webhooks.
2. Paste the full address, starting with https://, in the field for each event you want.
3. Click Save.

The address must be reachable on the public internet. Marketsy doesn't follow redirects, and it waits up to 10 seconds for your server to answer.

Try your webhook

Once an address is saved, a Try your webhook card appears under the form. Send a paid order sends a sample order to the paid-order address. The ⋯ menu next to it sends Order cancelled, New subscription or Subscription cancelled. A message confirms each one went out. Samples carry made-up data, not a real order.

What Marketsy sends

Each event is a POST request with a JSON body.

For orders, the body is the order:

• number, id, status, currency, price and formattedPrice
• taxAmount, taxRate, taxIncluded, discountAmount and promoCode
• customer, with email, fullName and phone, and delivery, with the address
• lines, one per item, with productId, name, quantity, price and totalPrice
• createdAt and updatedAt

For subscriptions, the body has id, status, price, currency, billingInterval, the product (id and name), the customer, createdAt and cancelledAt.

Orders come in the same format as the API's orders: see Use the Marketsy API.

On other plans the Webhooks page is greyed out with See plans. See Plans and what they include. For a setup without code, try Zapier.