API reference
Webhooks
Set an address and we'll POST a JSON event to it when something happens on your shops. You can also set it up on the API page in the app. Answer with any 2xx within 10 seconds; anything else shows as a failed delivery there.
Events
| Event | When |
|---|---|
listing.sold | Something sold |
offer.received | A buyer made an offer |
offer.updated | A buyer took your counter, turned it down or withdrew |
question.asked | A buyer sent a message |
order.completed | A buyer said it arrived and it's all good |
order.problem | A buyer reported a problem with an order |
order.refunded | An order was cancelled or refunded |
payout.sent | Money went to your PayPal |
review.created | A buyer left a review |
What we send
The object in data.object is the same shape the API returns: an offer, an order (for listing.sold, order.completed and payout.sent) a message (for question.asked) or a review (for review.created). The Resell-Event header repeats the type.
{
"id": "evt_8c1d2f…",
"object": "event",
"type": "offer.received",
"created_at": "2026-10-02T18:00:00.000Z",
"data": {
"object": {
"object": "offer",
"id": "5b0f…",
"status": "open",
"amount": 150,
"note": "Could pick up this weekend.",
"listing": {
"id": "8d1e6c2a-…",
"title": "Yellow Le Creuset dutch oven, 5.5 qt",
"price": 185
},
"shop": {
"slug": "maya",
"name": "Maya's closet"
},
"buyer": {
"name": "Jess"
}
}
}
}When it fails
If your server doesn't answer with a 2xx, we try again about 5 minutes, 30 minutes, 2 hours, 6 hours and a day later, six tries in all. Every try carries the same event id, so keep the ones you've handled and skip repeats. Retries can arrive after newer events, so go by created_at, or fetch the object from the API, rather than by arrival order.
If deliveries keep failing for three days, we turn the webhook off and say so on the API page. Fix your server, then save the webhook again to switch it back on.
Checking it's us
Each request has a Resell-Signature: t=1759428000,v1=5f2b… header. v1 is an HMAC-SHA256 of {t}.{raw body} with your signing secret. Compare it in constant time, and ignore anything older than five minutes.
import { createHmac, timingSafeEqual } from "node:crypto";
// In your handler, with the raw request body as a string
export function verify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ""));
}More addresses (Zapier)
Your webhook is one address. Subscriptions are more of them, each with its own events and its own signing secret, sent the same way and retried the same way. They're REST hooks: the resell.store Zapier app subscribes when a Zap is turned on and unsubscribes when it's turned off, and Make, n8n or your own integration can do the same. Answer a delivery with 410 Gone and we delete the subscription.
Samples (GET /webhooks/samples/:event) are events built from your own latest things, with test: true, for showing fields while a Zap is set up. See Zapier for setting one up without code.
Endpoints
Your webhook
/v1/webhooksWhere we send events, which ones, and how the last delivery went.
curl https://api.resell.store/v1/webhooks \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "webhook",
"url": "https://example.com/hooks/resell",
"events": [
"listing.sold",
"offer.received"
],
"enabled": true,
"secret_last4": "9fQa",
"last_delivery": {
"at": "2026-10-02T18:30:02.000Z",
"status": 200,
"error": null
}
}Set your webhook
/v1/webhooksSets the address we POST events to and which events to send. The first time, the response includes the signing secret; keep it to check the Resell-Signature header. Events: listing.sold, offer.received, offer.updated, question.asked, order.completed, order.problem, order.refunded, payout.sent, review.created.
Body
urlstringrequiredeventsstring[]- Which events to send. Defaults to listing.sold, offer.received and question.asked.
enabledboolean
curl -X PUT https://api.resell.store/v1/webhooks \
-H "Authorization: Bearer $RESELL_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/hooks/resell",
"events": [
"listing.sold",
"offer.received"
]
}'{
"object": "webhook",
"url": "https://example.com/hooks/resell",
"events": [
"listing.sold",
"offer.received"
],
"enabled": true,
"last_delivery": null,
"secret": "whsec_…"
}Stop webhooks
/v1/webhookscurl -X DELETE https://api.resell.store/v1/webhooks \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "webhook",
"url": null,
"events": [],
"enabled": false
}New signing secret
/v1/webhooks/rotate-secretMakes a new signing secret. The old one stops working at once.
curl -X POST https://api.resell.store/v1/webhooks/rotate-secret \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "webhook",
"url": "https://example.com/hooks/resell",
"events": [
"listing.sold",
"offer.received"
],
"enabled": true,
"last_delivery": {
"at": "2026-10-02T18:30:02.000Z",
"status": 200,
"error": null
},
"secret": "whsec_…"
}Send a test event
/v1/webhooks/testSends a ping event to your address now and tells you what your server answered.
curl -X POST https://api.resell.store/v1/webhooks/test \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "webhook_test",
"event": "evt_…",
"status": 200,
"error": null
}List subscriptions
/v1/webhooks/subscriptionsEvery extra address getting events, each with its own events: one per Zap made with the resell.store Zapier app, plus any you added yourself.
curl https://api.resell.store/v1/webhooks/subscriptions \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "list",
"data": [
{
"object": "webhook_subscription",
"id": "3f9c2b1a-…",
"url": "https://hooks.zapier.com/hooks/standard/1234567/abcdef/",
"events": [
"listing.sold"
],
"name": "Add sales to my sheet",
"source": "zapier",
"enabled": true,
"secret_last4": "x7Lp",
"last_delivery": {
"at": "2026-10-02T18:30:02.000Z",
"status": 200,
"error": null
},
"created_at": "2026-10-01T09:00:00.000Z"
}
],
"total": 1,
"has_more": false
}Subscribe an address
/v1/webhooks/subscriptionsStarts sending some events to another address, alongside your webhook. This is the REST hook Zapier calls when a Zap is turned on; Make, n8n and Pipedream can use it the same way. Subscribing an address you already have updates its events. Answer a delivery with 410 Gone and we delete the subscription. Up to 50. The response includes its signing secret.
Body
urlstringrequiredeventsstring[]requirednamestring- What to call it on the API page, like the Zap's name.
curl https://api.resell.store/v1/webhooks/subscriptions \
-H "Authorization: Bearer $RESELL_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://hooks.zapier.com/hooks/standard/1234567/abcdef/",
"events": [
"listing.sold"
],
"name": "Add sales to my sheet"
}'{
"object": "webhook_subscription",
"id": "3f9c2b1a-…",
"url": "https://hooks.zapier.com/hooks/standard/1234567/abcdef/",
"events": [
"listing.sold"
],
"name": "Add sales to my sheet",
"source": "zapier",
"enabled": true,
"last_delivery": null,
"created_at": "2026-10-01T09:00:00.000Z",
"secret": "whsec_…"
}Unsubscribe an address
/v1/webhooks/subscriptions/:idStops sending events there. Zapier calls this when a Zap is turned off or deleted.
Path
idstringrequired- The id.
curl -X DELETE https://api.resell.store/v1/webhooks/subscriptions/3f9c2b1a-… \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "webhook_subscription",
"id": "3f9c2b1a-…",
"deleted": true
}Send a sample to a subscription
/v1/webhooks/subscriptions/:id/testPosts a sample event now, built from your latest real one (your newest sale for listing.sold, and so on), marked test: true and never retried. Handy when Zapier is waiting for a request to learn the fields.
Path
idstringrequired- The id.
Body
event"listing.sold" | "offer.received" | "offer.updated" | "question.asked" | "order.completed" | "order.problem" | "order.refunded" | "payout.sent" | "review.created"- Which event to send. Defaults to the subscription's first.
curl https://api.resell.store/v1/webhooks/subscriptions/3f9c2b1a-…/test \
-H "Authorization: Bearer $RESELL_KEY" \
-d event=listing.sold{
"object": "webhook_test",
"event": "evt_…",
"type": "listing.sold",
"status": 200,
"error": null
}Sample events
/v1/webhooks/samples/:eventWhat an event looks like, from your own latest matching things, newest first (made up if you have none yet). Each is the full event we'd POST, marked test: true. The Zapier app shows these when you test a trigger.
Path
eventstringrequired- The id.
Query
limitintegerdefault 3
curl https://api.resell.store/v1/webhooks/samples/offer.received \
-H "Authorization: Bearer $RESELL_KEY"{
"object": "list",
"data": [
{
"id": "evt_sample_5b0f9a123c4d",
"object": "event",
"type": "offer.received",
"created_at": "2026-10-02T18:00:00.000Z",
"test": true,
"data": {
"object": {
"object": "offer",
"id": "5b0f…",
"status": "open",
"amount": 150,
"shop": {
"slug": "maya",
"name": "Maya's closet"
}
}
}
}
],
"has_more": false
}