Update project webhook URL

Updates the webhook URL for the current project based on the specified type (trigger or event). Webhook URLs are endpoints that receive notifications about events in your project. “Trigger” webhooks receive integration trigger events, while “event” webhooks receive system notifications. This endpoint allows you to set or change these notification destinations.

Headers

x-api-keystringRequired

Request

This endpoint expects an object.

typeenumRequired

Specifies which webhook type to update (trigger or event)

Allowed values:

webhook_urlstringRequiredformat: "uri"

Valid URL that will receive webhook payloads. Must include https:// protocol.

Response

Webhook URL updated successfully. The project will now send notifications to the new URL.

successboolean

Indicates if the webhook URL update was completed successfully

messagestring

Human-readable description of the update operation result

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/org/project/webhook/update"
4
5	payload = {
6	"type": "trigger",
7	"webhook_url": "https://example.com/api/webhooks/triggers"
8	}
9	headers = {
10	"x-api-key": "<x-api-key>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"success": true,
3	"message": "Webhook URL updated successfully"
4	}