---
title: "Put webhook endpoint configuration"
method: POST
path: "/api/v3.1/webhook_endpoints/{nano_id}"
tags: ["Webhook Endpoints"]
---

# Put webhook endpoint configuration

`POST /api/v3.1/webhook_endpoints/{nano_id}`

Full replacement of webhook endpoint configuration. All required setup fields must be provided. Use PATCH to update individual fields.

## Path parameters

- `nano_id` string, required — Webhook endpoint nano ID (e.g., we_abc123)

## Request body

- object
  - `data` object, required — Key-value pairs for ALL required setup_fields. Unlike PATCH, all required fields must be provided — this is initial configuration.

## Response `200`

Configured

- 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

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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