> ## Documentation Index
> Fetch the complete documentation index at: https://developers.1-funnel.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure endpoints

> Create, update, list, and delete webhook endpoints.

<Warning>
  **Developer Preview**

  This documentation describes the upcoming 1Funnel External Integration API.

  The documented API endpoints and authentication services are not yet available
  for public integration.

  You can explore the API specifications, request and response schemas, webhook
  events, and integration guides.

  Sandbox and production availability will be announced separately.
</Warning>

`POST /v1/businesses/{businessId}/webhook-endpoints`

Permission: `webhook.endpoint.write`.

```bash theme={null}
curl -X POST "https://api.sandbox.1-funnel.org/v1/businesses/{businessId}/webhook-endpoints" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/1funnel",
    "event_types": ["sms.message.delivered.v1"]
  }'
```

The create response discloses `signing_secret` **once**. Store it securely.
GET/LIST never return the secret. Public rotation is not available in v1
(internal rotation only). Endpoint ownership verification is deferred — endpoints
may be `active` after destination security validation. DELETE soft-deactivates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.