Webhooks

Webhooks let your systems react to important events as they happen on Authentified — a listing being added, sold, or donated for example — without needing to poll our APIs.

When something interesting happens on a listing, user, or fulfilment, we send a POST request to the URL you give us with a JSON payload describing what happened.

How it works

1. You give us a URL we should call when events happen.
2. We send a POST request with a JSON body whenever a matching event fires.
3. You respond with a 2xx status to acknowledge receipt. Anything else is treated as a failure and we retry.
4. We keep a record of every delivery — successful or failed — so we can investigate together if something goes wrong.

NOTE

Webhooks are configured by our team during onboarding. If you'd like to receive events into Klaviyo, your CRM, an iPaaS like Zapier or Make, or your own backend, get in touch and we'll set it up for you.

What you'll receive

Every webhook delivery contains:

• type — the event name, e.g. listing.sold (see the event catalogue below).
• payload — a JSON object with the data relevant to that event (the user, the listing, the fulfilment, etc.).
• uuid — a unique identifier for the delivery, useful for de-duplication on your end.

Payloads are sanitised before sending — internal identifiers, system fields, and anything that isn't useful to an external system are stripped out.

Example payload

{
  "id": "85352",
  "user": {
    "type": "personal",
    "email": "person@domain.com",
  },
  "token": {
    "hash": "ca9595121bb1a8f1d1a2e64bab47b4c46e74a45d358dc015b40eb9af8c02f69c",
    "relatedProduct": {
      "size": "L",
      "brand": "Zara",
      "title": "Cropped Wool Blend Jacket",
      "colour": "Light Grey",
      "productMedia": {
        "edges": []
      }
    }
  },
  "payout": null,
  "photos": {
    "edges": [
      {
        "node": {
          "id": "139891",
          "largeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1200/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
          "position": 0,
          "smallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_400/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
          "mediumURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_800/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
          "xlargeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1600/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
          "xsmallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_200/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
          "externalId": "l7zbpsrtovssit3blgi7",
          "originalURL": "https://res.cloudinary.com/authentified/image/upload/v1781154099/l7zbpsrtovssit3blgi7.jpg",
          "thumbnailURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_100/l7zbpsrtovssit3blgi7?_a=DATAiZXyZAA0",
        }
      },
      {
        "node": {
          "id": "139892",
          "largeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1200/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
          "position": 1,
          "smallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_400/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
          "mediumURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_800/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
          "xlargeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1600/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
          "xsmallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_200/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
          "externalId": "a5z6vfplwrp1reufoxsb",
          "originalURL": "https://res.cloudinary.com/authentified/image/upload/v1781154146/a5z6vfplwrp1reufoxsb.jpg",
          "thumbnailURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_100/a5z6vfplwrp1reufoxsb?_a=DATAiZXyZAA0",
        }
      },
      {
        "node": {
          "id": "139893",
          "largeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1200/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
          "position": 2,
          "smallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_400/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
          "mediumURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_800/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
          "xlargeURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_1600/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
          "xsmallURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_200/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
          "externalId": "gze7kbqfipl1s8e4jb4h",
          "originalURL": "https://res.cloudinary.com/authentified/image/upload/v1781154100/gze7kbqfipl1s8e4jb4h.jpg",
          "thumbnailURL": "https://res.cloudinary.com/authentified/image/upload/c_fit,w_100/gze7kbqfipl1s8e4jb4h?_a=DATAiZXyZAA0",
        }
      }
    ]
  },
  "soldAt": null,
  "status": "sold",
  "condition": "new",
  "createdAt": "2026-06-11T05:02:34.682Z",
  "donatedAt": null,
  "soldPrice": null,
  "updatedAt": "2026-06-11T05:02:57.660Z",
  "cancelledAt": null,
  "marketplace": "ebay",
  "publishedAt": null,
  "currentPrice": 65,
  "minimumPrice": 40,
  "orderLineItem": null,
  "startingPrice": 65,
  "usedCondition": null,
}

Reliability

• We retry failed deliveries automatically until they succeed or we give up.
• Each delivery is hashed so the same event isn't sent twice — safe to subscribe multiple systems to the same URL behind a load balancer.
• We log the response status and body from your endpoint so we can diagnose delivery problems together.

Choosing what you receive

You can subscribe to:

• Specific events — only listing.sold and listing.complete, for example.
• All events (catch-all) — every event we emit, useful for building a full audit log or replicating data into a warehouse.

Tell us which option suits you when you onboard.

PRIVACY NOTE

We only send webhooks for connected products (i.e. listed via your order history page) that are consigned by your existing customers only. We do not send webhooks for non-connected products and users.

Event catalogue

The events below are everything Authentified currently emits. We'll add new event types over time — existing ones won't be removed or renamed without notice.

Listings

Events about the lifecycle of a listing — from creation through to sale, donation, or cancellation.

Event	When it fires
listing.in-review	A listing is being reviewed by our team before going live.
listing.listed	A listing has been published to one or more marketplaces.
listing.sold	A listing has been sold to a buyer.
listing.complete	A listing has completed end-to-end (item received by the buyer, payout sent to the seller).
listing.cancelled	A listing has been cancelled before sale.
listing.donated	A listing has been donated rather than sold.

Common use cases

• Email and SMS automations — pipe listing.sold, listing.complete into Klaviyo to send offers and promotions to customers.
• Internal dashboards — replicate the full event stream into a warehouse for reporting.

Need a new event?

If you have a use case that isn't covered by the events above, let us know via our Canny site and we'll consider adding it.