---
search:
  tags:
    - Webhooks
    - POST
seo:
  description: >-
    Registers an organization-wide endpoint and returns its signing secret
    exactly… Reference for the POST /webhook-endpoints endpoint in the AI Inbx
    API API.
sidebar:
  label: Create a webhook endpoint
  badge: POST
title: Create a webhook endpoint
type: openapi-operation
---
Registers an organization-wide endpoint and returns its signing secret exactly once, in the `secret` field. `subscriptions` must name at least one event type. Optional routing rules narrow delivery by sender or recipient: a matching `block` rule always wins, and an empty allow list means no opinion. The endpoint receives every space's events, each stamped with its `space_id`.

<Operation source="api-endpoints" id="create-webhook-endpoint" />
