Receive important moments without continuously watching Dexyd.

Webhooks notify your tools when a useful action happens in Dexyd: a contest changes, a new submission arrives, an Expo request appears, a commercial signal is raised, or a step needs follow-up.

AlertsAlerts at the right time.

ResponseFaster response.

TrackingLess manual checking.

Contests

Track key steps as soon as they move forward.

Participations

Spot new submissions faster.

Expo

Route commercial requests to the right place.

Setup

Create and test a webhook

A webhook links an HTTPS URL, selected events and a signing secret generated by Dexyd.

Console

/developer

Create, test, disable and inspect deliveries.

GET /api/developer/webhooks

List webhooks for the signed-in account.

POST /api/developer/webhooks

Create a destination and receive the full secret once.

PATCH /api/developer/webhooks/{id}

Update the URL, events or status.

DELETE /api/developer/webhooks/{id}

Revoke a destination.

POST /api/developer/webhooks/{id}/test

Send test.ping to the configured URL.

Events

Events currently emitted

Subscribe only to the flows your tool needs to avoid unnecessary processing.

competition.created

A contest is created.

competition.updated

A contest is updated.

submission.created

A submission is received.

submission.updated

A submission changes status or content.

expo_product.created

An Expo product is published or prepared.

expo_product.updated

An Expo product is updated.

expo_product.bid.created

An Expo bid is recorded.

expo_product.inquiry.created

An Expo commercial request is created.

test.ping

Verification event sent from the console.

Delivery

Payload, signature and verification

Dexyd signs every outgoing POST so your server can verify the origin and reject replays.

Payload

{
  "id": "delivery_...",
  "event": "submission.created",
  "created_at": "2026-06-11T12:00:00.000Z",
  "data": {
    "competition_id": "...",
    "submission_id": "..."
  }
}

Headers

X-Dexyd-Event: submission.created
X-Dexyd-Delivery: delivery_...
X-Dexyd-Timestamp: 1781179200
X-Dexyd-Signature: t=1781179200,v1=<hmac_sha256>

The v1 signature is an HMAC SHA-256 over timestamp.body using the whsec secret.
Dexyd waits 8 seconds for your endpoint and records status, HTTP code and a response excerpt.

Errors

Destination states to handle

Your endpoint should respond quickly, verify the signature and process events idempotently.

2xx

Delivery is marked delivered.

4xx / 5xx

Delivery is marked failed with the response code.

Timeout or network

Delivery is marked failed with the error message.

Lost secret

Create a new destination or rotate from the console.