Sentra
Webhooks

Create webhook

Creates a new webhook subscription

POST
/webhooks
X-API-KEY<token>

API key for authentication (prefix: sk_dev_ for development, sk_live_ for production)

In: header

urlstring
Formaturi
secret?string
events?array<string>

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.sentra.xyz/api/v1/webhooks" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "url": "http://example.com",
  "secret": "string",
  "events": [
    "payment.updated"
  ],
  "isActive": true,
  "metadata": {},
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}
{
  "message": "Validation failed",
  "statusCode": 400,
  "details": {
    "field": "email",
    "message": "Invalid email format"
  }
}
{
  "message": "Unauthorized",
  "statusCode": 401
}
{
  "message": "Internal server error",
  "statusCode": 500
}