Webhook Alerts Are Here: Connect Marketplace Matches to Your Workflow
Webhook alerts are now available for every Classifindr account. They give you another way to use a match: send it to a dashboard, buying tracker, team workflow, or automation you control.
What you can receive
V1 supports two customer events:
- New listing matches, with the search, match context, listing details, and source link.
- Price decreases, with the previous and current price so your workflow can spot a better opportunity.
Each event is versioned JSON using CloudEvents. The payload is designed for customer work, not scraper internals. It does not include marketplace credentials, seller contact details, raw provider payloads, coordinates, or internal scoring data.
A practical setup
- Create a webhook endpoint in the desktop web portal.
- Save the
whsec_signing secret when it is shown. - Verify the endpoint with the signed test event.
- Assign the channel to the searches that should send it.
- Use delivery history to see successes, retries, and safe failure reasons.
The portal keeps delivery attempts for 30 days, supports secret rotation and manual redelivery, and can pause an endpoint after repeated failures.
Keep your receiver safe
Webhooks use HTTPS and Standard Webhooks headers. Verify the signature against the raw request bytes, allow a five-minute timestamp tolerance, deduplicate by Webhook-Id, and return a 2xx response quickly. Delivery is at least once and unordered, so your receiver should not process the same event twice or rely on arrival order.
Verification proves that a signed request reached the endpoint and received a 2xx response. It does not prove ownership. Only configure an endpoint you are allowed to use. Webhook creation, verification, rotation, and delivery inspection are managed in the desktop web app. Mobile can view and assign active webhook channels.
See the webhook alerts feature page, alert schema, test schema, and notification channel planner for the next step.