Webhooks

Receive HTTP callbacks when marketplace events occur instead of polling the API.

Manage webhooks via the dashboard or the v1 API.

POST/v1/webhooksRequires write

Register a webhook endpoint

bash
curl -X POST "https://api.midasai.tech/v1/webhooks" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production",
    "url": "https://example.com/webhooks/midasai",
    "events": ["listing.created", "purchase.completed"]
  }'

Supported events

listing.createdA new listing is submitted
listing.updatedA listing is updated
listing.publishedA listing goes active
purchase.completedA purchase completes
review.createdA new review is posted

Verifying signatures

Each webhook receives a whsec_ secret on creation. Validate the X-MidasAI-Signature header on incoming payloads before processing.