// integration

Custom webhook

Traken's generic webhook endpoint accepts a structured JSON payload. Use it in custom scripts, CI/CD pipelines, or any tool you can configure freely.

Prerequisites: You must be a workspace Admin.

Set up the connection

1Go to Integrations.
2
Fill in:
- Type — select "Custom"
- Name — a label for this connection.
3Click Create connection. Traken generates a Webhook URL and a Secret token.
4Copy both. The secret token is shown once.

Sending an event

Send a POST request to your webhook URL with:

Header: Authorization: Bearer <secret_token>
Header: Content-Type: application/json
Body: JSON payload (see schema below)

Payload schema

Field	Type	Required	Notes
title	string	Yes	Release name — appears as-is in the Traken feed
released_at	string	Yes	ISO 8601 datetime, e.g. `2024-03-15T14:30:00Z`
team	string	No	Team name — appears as-is in the Traken feed
subsystem	string	No	Subsystem name — appears as-is in the Traken feed
logged_by	string	No	User who logged the release
description	string	No	Free text or Markdown — appears in the release detail view

Example

curl -X POST https://app.traken.dev/api/public/webhooks/custom/<connection-id> \
  -H "Authorization: Bearer <secret_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "v3.1.0",
    "released_at": "2024-03-15T14:30:00Z",
    "description": "Hotfix for payment timeout"
  }'

A 200 response means the release was created. A 401 means the token is invalid or missing.