Developer tools

Create webhook destination

Select a public destination and lifecycle events; receive its signing secret.

POST/v1/webhook-endpoints

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

Requires an Idempotency-Key. The signing secret is returned only on creation or rotation, including a safe replay of that exact command. Keep it on your server; it is not an API access token. No real message is sent until a subscribed workflow event occurs.

Request body

namestringrequiredmin length 1 · max length 80

urlstringrequireduri · max length 2048

eventsarrayrequiredmin items 1 · max items 20

activebooleanoptionaldefault true

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

curl -X POST "https://api.flowg8.io/v1/webhook-endpoints" \ -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-create-webhook-001" \ -H "content-type: application/json" \ --data-raw '{ "name": "ERP approvals", "url": "https://api.example.com/webhooks/flowg8", "events": [ "gate.activated", "gate.approved", "gate.rejected", "run.approved", "run.rejected" ], "active": true }'

Developer tools

Create webhook destination

Select a public destination and lifecycle events; receive its signing secret.

POST/v1/webhook-endpoints

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

Request body

namestringrequiredmin length 1 · max length 80

urlstringrequireduri · max length 2048

eventsarrayrequiredmin items 1 · max items 20

activebooleanoptionaldefault true

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Create webhook destination

How it works

Request body

Request essentials

Ask the docs

Create webhook destination

How it works

Request body

Request essentials

Ask the docs