FruxonDocs
IntegrationsWebhooks

Create a webhook.

Provisions an inbound webhook in Fruxon and, where the provider supports it, registers the corresponding listener on the external system. The created webhook exposes a URL of the form `{webhookProvider}/{webhookId}` that the external system POSTs to — wire this into the provider's UI or hand it to a connector. Attach subscribers (agents, assets, connectors) with `POST WebhookSubscriptions` so inbound events route somewhere.

POST
/v1/tenants/{tenant}/webhooks
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

provider*string|null
externalContext?string|null

Provider-specific context for registration. Jira: the instance base URL. GitHub: the repository in 'owner/repo' format.

filter?string|null

Provider-specific filter (e.g. JQL for Jira).

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/webhooks" \  -H "Content-Type: application/json" \  -d '{    "provider": "string"  }'
{
  "id": "string",
  "provider": "string",
  "authMode": "API_KEY",
  "status": "ACTIVE",
  "expiresAt": 0,
  "createdAt": 0,
  "modifiedAt": 0,
  "webhookUrl": "string",
  "signingSecret": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty