API ReferenceWebhook Endpoints

Update webhook endpoint configurationv3.0

Markdown
PATCH
/api/v3/webhook_endpoints/{nano_id}

Updates app-specific secrets and credentials. Uses merge semantics — only included fields are updated; omitted fields are preserved. Can be called on active endpoints (e.g., to rotate a signing secret).

Authorization

x-api-key<token>

Project API key authentication

In: header

Path Parameters

nano_idstringRequired

Webhook endpoint nano ID (e.g., we_abc123)

Request Body

application/json

dataobjectRequired

Key-value pairs matching the toolkit's setup_fields. Only include fields you want to update — omitted fields are preserved.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://backend.composio.dev/api/v3/webhook_endpoints/string" \  -H "Content-Type: application/json" \  -d '{    "data": {      "property1": "string",      "property2": "string"    }  }'
{
  "id": "string",
  "toolkit_slug": "string",
  "client_id": "string",
  "webhook_url": "string",
  "data": {
    "property1": "string",
    "property2": "string"
  },
  "created_at": "string"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}