Webhooks

Create a webhook endpoint

Starts sending your workspace's events to an https URL: every type by default (["*"], including types added later), or the ones you list. Runs started from the API, the studio and MCP all send events. The answer holds the endpoint's signing secret, shown only here and when you rotate it. A workspace can have up to 16 endpoints; one more answers 409.

Needs an API key with the generations:write scope.

post/v1/webhook_endpoints

Request

  • Base URL: https://api.tryleap.ai
  • URL: https://api.tryleap.ai/v1/webhook_endpoints
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

urlstring uri required

Where Leap POSTs events: an https URL that answers 2xx within 15 seconds.

eventsstring[]

The event types to send. ["*"], the default, sends every type, including types added later.

descriptionstring nullable

A note for people, such as which app this is.

Response

The endpoint, with its signing secret.

idstring required

The endpoint's ID, we_....

object'webhook_endpoint' required
urlstring required

Where Leap POSTs events.

descriptionstring nullable required

Your note, if any.

eventsstring[] required

The event types it gets; ["*"] for every type, including types added later.

disabledboolean required

Whether deliveries to it are stopped.

disabled_reasonstring nullable required

Why Leap disabled the endpoint, such as every delivery failing for 72 hours; null when it is on or you turned it off.

created_atstring date-time required

When it was created.

updated_atstring date-time required

When it last changed.

secretstring required

The signing secret, whsec_ and base64. Shown only here: keep it in your server's environment.

Changes

No recorded changes to this operation across all 1 revision of this API.