# Flowg8 · Webhook-Ziel erstellen

Wähle ein öffentliches Ziel und Flow-Ereignisse; erhalte das Signing-Secret.

Erfordert einen Idempotency-Key. Das Signing-Secret wird nur bei Erstellung oder Erneuerung zurückgegeben, einschließlich sicherer Wiederholung derselben Anfrage. Speichere es auf deinem Server; es ist kein API-Access-Token. Eine echte Nachricht wird erst bei einem abonnierten Flow-Ereignis gesendet.

## POST /v1/webhook-endpoints

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Administrator oder Sandbox-Entwickler erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Input parameters
- name (string, required): min length 1 · max length 80
- url (string, required): uri · max length 2048
- events (array, required): min items 1 · max items 20
- active (boolean, optional): default true

## Request example (replace example IDs)

```sh
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
}'
```

## Response excerpt

```json
{
  "endpoint": {
    "id": "10000000-0000-4000-8000-000000000008",
    "name": "ERP approvals"
  },
  "signingSecret": "fg_whsec_<private signing secret>"
}
```

Source: /docs/create-webhook
Full schemas: /docs/openapi.json