Endpoints

Method	Path	Purpose
POST	/webhooks	Create
GET	/webhooks	List
GET	/webhooks/:id	Get one
PATCH	/webhooks/:id	Update
DELETE	/webhooks/:id	Remove
GET	/webhooks/:id/deliveries	Inspect recent deliveries

POST /webhooks

curl -X POST https://api.socifyr.com/api/webhooks \
  -H "Authorization: Bearer sk_..." \
  -H "X-Workspace-Id: <workspaceId>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://myapp.com/webhooks/socifyr",
    "events": ["upload.completed", "upload.failed", "upload.partial_failure"],
    "secret": "whsec_..."
  }'

Field	Description
url	HTTPS endpoint that receives events
events	Array of event names
secret	Used to sign deliveries — Socifyr generates one if omitted

See Webhook events for the full event list.

GET /webhooks/:id/deliveries

{
  "success": true,
  "data": [
    {
      "id": "...",
      "event": "upload.completed",
      "url": "https://myapp.com/webhooks/socifyr",
      "statusCode": 200,
      "deliveredAt": "...",
      "attempts": 1,
      "responseBody": "{ \"ok\": true }"
    }
  ]
}

The 100 most-recent deliveries are kept.