2xx response and retry until they get one, so the same event can arrive more than once. A handler that does slow work before answering, or answers before saving the event, can time out, run twice or lose the event.
What happens to a request
- Verify. The endpoint checks the provider’s signature or secret with the endpoint’s credential. A request that fails is rejected and never reaches a subscriber. Provider handshakes, such as Slack’s URL check, are answered here and create no delivery.
- Deduplicate. A retry of an event that already arrived is answered as a duplicate. Most built-in providers dedupe on the provider’s event ID.
- Store, then answer. The delivery is durably stored before the provider gets its
200. Once the provider has its answer it stops retrying, and Trigger.dev is responsible for the event from then on. - Route. Each subscriber’s filter is checked. Matching tasks start a run, matching waiters resume their paused runs, and agent sessions receive the event as a message.
429 with Retry-After, so the provider sends the event again later instead of dropping it. See Limits.
Endpoints are declared in code
You declare an endpoint next to your tasks withwebhooks.endpoint.define(). When you run trigger dev or deploy, the CLI sends the endpoints it finds to Trigger.dev, and the environment is synced to match: new endpoints are created, and removed ones are deactivated but keep their URL and secret, so adding one back restores it.
Each environment gets its own URL for each endpoint. Your dev environment has its own URL too, so you don’t need a tunnel for local development. A delivery that arrives while trigger dev isn’t running waits for it like any other dev run.
One endpoint, many subscribers
A provider account usually needs one URL, so every subscriber shares the endpoint. One delivery can start task runs, resume waiting runs and reach agent sessions at the same time. See What can subscribe. A delivery that no filter matches is recorded asFILTERED and starts no run, so it costs nothing. See Pricing and limits.
Retries and duplicates
Duplicates are caught in two places:- When the webhook arrives. A retry with the same event ID is answered as a duplicate and isn’t stored again.
- When the run starts. Each delivery triggers its task with an idempotency key built from the endpoint and the event, kept for the provider’s retry window. A retry that gets past the first check finds the existing run instead of starting a second one.

