Create a webhook

Registers an endpoint to receive events. Set scope to account to receive events from every profile through one endpoint.

Category: Webhooks
Calls: POST/v1/webhooks
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

urlstringrequired

HTTPS endpoint that will receive POSTs.

eventsenum | string[]required

Event types to subscribe to, or ["*"] for everything.

scopeenumoptional

Defaults to profile.

One of:profileaccount

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

Example

A tool call as an MCP client would send it.

{
  "name": "create_webhook",
  "arguments": {
    "url": "https://cdn.example.com/media/launch.jpg",
    "events": [
      "account.connected"
    ]
  }
}