Syndai Docs

Create a webhook endpoint

POST
/api/v1/external/coding/webhooks

Register a webhook endpoint to receive deliveries for your runs. The response carries the endpoint's signing secret exactly once: store it then, it is never returned again. Requires the coding:webhooks:write scope.

Authorization

CustomerApiKey
headerAuthorizationBearer <API Key>

Customer API key sent as a bearer token

Query Parameters

customer_id?|null

Request Body

application/json
  1. body
event_types?array<>
name*string
target_url*string

Response Body

Document created, URL follows

application/json
  1. response
endpoint*
signing_secret*string
Formatpassword
Example Request
curl -X POST 'https://api.syndai.ai/api/v1/external/coding/webhooks' \  -H 'Content-Type: application/json' \  -d '{  "event_types": [    "coding.run.completed",    "coding.run.failed"  ],  "name": "Ops alerts",  "target_url": "https://hooks.example.com/syndai"}'
Example Response
{  "endpoint": {    "created_at": "2026-10-27T09:00:00Z",    "customer_id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",    "event_types": [      "coding.run.completed",      "coding.run.failed"    ],    "id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",    "name": "Ops alerts",    "status": "active",    "target_url": "https://hooks.example.com/syndai",    "updated_at": "2026-10-27T09:00:00Z"  },  "signing_secret": "example-signing-secret-shown-once"}