API reference

Webhooks

Get told when something happens.

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

EventWhen
listing.soldSomething sold
offer.receivedA buyer made an offer
offer.updatedA buyer took your counter, turned it down or withdrew
question.askedA buyer sent a message
order.completedA buyer said it arrived and it's all good
order.problemA buyer reported a problem with an order
order.refundedAn order was cancelled or refunded
payout.sentMoney went to your PayPal
review.createdA 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.

POST to your address
{
  "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.

Node
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

GET/v1/webhooks
Needs a key with webhooks

Where we send events, which ones, and how the last delivery went.

Request
curl https://api.resell.store/v1/webhooks \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "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

PUT/v1/webhooks
Needs a key with webhooks

Sets 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

urlstringrequired
eventsstring[]
Which events to send. Defaults to listing.sold, offer.received and question.asked.
enabledboolean
Request
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"
    ]
  }'
Response
{
  "object": "webhook",
  "url": "https://example.com/hooks/resell",
  "events": [
    "listing.sold",
    "offer.received"
  ],
  "enabled": true,
  "last_delivery": null,
  "secret": "whsec_…"
}

Stop webhooks

DELETE/v1/webhooks
Needs a key with webhooks
Request
curl -X DELETE https://api.resell.store/v1/webhooks \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "webhook",
  "url": null,
  "events": [],
  "enabled": false
}

New signing secret

POST/v1/webhooks/rotate-secret
Needs a key with webhooks

Makes a new signing secret. The old one stops working at once.

Request
curl -X POST https://api.resell.store/v1/webhooks/rotate-secret \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "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

POST/v1/webhooks/test
Needs a key with webhooks

Sends a ping event to your address now and tells you what your server answered.

Request
curl -X POST https://api.resell.store/v1/webhooks/test \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "webhook_test",
  "event": "evt_…",
  "status": 200,
  "error": null
}

List subscriptions

GET/v1/webhooks/subscriptions
Needs a key with webhooks

Every extra address getting events, each with its own events: one per Zap made with the resell.store Zapier app, plus any you added yourself.

Request
curl https://api.resell.store/v1/webhooks/subscriptions \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "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

POST/v1/webhooks/subscriptions
Needs a key with webhooks

Starts 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

urlstringrequired
eventsstring[]required
namestring
What to call it on the API page, like the Zap's name.
Request
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"
  }'
Response
{
  "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

DELETE/v1/webhooks/subscriptions/:id
Needs a key with webhooks

Stops sending events there. Zapier calls this when a Zap is turned off or deleted.

Path

idstringrequired
The id.
Request
curl -X DELETE https://api.resell.store/v1/webhooks/subscriptions/3f9c2b1a-… \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "webhook_subscription",
  "id": "3f9c2b1a-…",
  "deleted": true
}

Send a sample to a subscription

POST/v1/webhooks/subscriptions/:id/test
Needs a key with webhooks

Posts 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.
Request
curl https://api.resell.store/v1/webhooks/subscriptions/3f9c2b1a-…/test \
  -H "Authorization: Bearer $RESELL_KEY" \
  -d event=listing.sold
Response
{
  "object": "webhook_test",
  "event": "evt_…",
  "type": "listing.sold",
  "status": 200,
  "error": null
}

Sample events

GET/v1/webhooks/samples/:event
Needs a key with read

What 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
Request
curl https://api.resell.store/v1/webhooks/samples/offer.received \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "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
}