---
title: "Create webhook endpoint"
method: POST
path: "/api/v3.1/webhook_endpoints"
tags: ["Webhook Endpoints"]
---

# Create webhook endpoint

`POST /api/v3.1/webhook_endpoints`

Creates a shared webhook endpoint for a toolkit + OAuth app + project. Returns the webhook URL that the customer registers in their app dashboard. Idempotent — returns existing endpoint if one already exists for this toolkit + client_id + project.

## Request body

- object
  - `toolkit_slug` string, required — Toolkit identifier (e.g., slack, discord)
  - `client_id` string, required — OAuth app client ID — identifies which app this endpoint is for

## Response `200`

Existing webhook endpoint returned

- object
  - `id` string, required — Webhook endpoint nano ID
  - `toolkit_slug` string, required — Toolkit this endpoint is for
  - `client_id` string, nullable, required — OAuth app client ID
  - `webhook_url` string, required — The webhook URL to register with the provider
  - `data` object, nullable, required — Configured fields with secret values masked
  - `created_at` string, required — ISO 8601 timestamp

## Other responses

- `201` — Webhook endpoint created
- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-06-17** `589a7d115a5e` — 2 info
  - the endpoint scheme security `CookieAuth` was removed from the API
  - the endpoint scheme security `UserApiKeyAuth` was removed from the API
- **2026-05-08** `55e9c3b27c95` — 2 info
  - api tag `Webhook Endpoints` added
  - api tag `Webhooks` removed
- **2026-05-05** `52c71f747c65` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/changes/api/v3.1/webhook_endpoints/post.md)

---

[API](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)