Enable a webhook endpoint
Private beta: request access to use webhooks. Resume a disabled endpoint so its URL accepts deliveries again. Returns the updated endpoint.
Authorizations
Use a named environment API key. It starts with tr_dev_sk_, tr_prod_sk_, tr_stg_sk_, etc.
Create a named API key in the API Keys section of your Trigger.dev project dashboard. Choose the narrowest access preset that supports your integration.
Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.
Path Parameters
The endpoint's declared id (the id passed to webhooks.endpoint.define) or its wh_ id. A value starting with wh_ is always a generated id, since declared ids can't start with wh_. A declared id names the endpoint's declared instance in the key's environment.
Response
Successful request
The endpoint's id.
"wh_cm1a2b3c4d5e6f"
The id the endpoint is declared with in code (webhooks.endpoint.define({ id })).
"stripe"
The provider source that verifies and types the endpoint's events.
"stripe"
active accepts deliveries. inactive was disabled, or is no longer in the current deployment, and its URL responds with 404.
active, inactive, deleting Who supplies the signing secret: provider issues it (store it with the set secret endpoint), integrator means you choose it (generate one), and either accepts both.
provider, integrator, either Whether a signing secret or public key is set. Every delivery is rejected until it is.
Reserved for dynamic endpoints. null for a declared endpoint.
Reserved for dynamic endpoints. null for a declared endpoint.
The webhook URL to register with the provider.
"https://api.trigger.dev/webhooks/v1/ingest/q3Xb7k2LmP9sT4vW1yZ0aQ"
The tasks and agents that receive the endpoint's deliveries.
Instructions for an AI coding agent to register the endpoint with its provider and set up the signing secret.

