1
Add Trigger.dev to your project
Skip this step if your project already uses Trigger.dev 4.8.1 or later.To upgrade an existing project, install the SDK and CLI from
@latest:2
Declare the endpoint and a subscriber
Create a file in your
/trigger directory. The endpoint is the hosted URL; the subscriber is the task that runs for each event./trigger/github.ts
3
Run the dev server
github endpoint you declared in your Development environment.4
Generate the signing secret
In the Trigger.dev dashboard, open your project, make sure the Development environment is selected, and choose Webhooks in the side menu. The
github endpoint is listed with its Signing secret column set to Needs secret. Every delivery is rejected until an endpoint has its secret.Open the github endpoint, choose Generate secret and confirm. The secret is shown once: copy it if you’ll connect GitHub later. Back on the Webhooks page, the column now says Ready.5
Send a test event
On the
github endpoint’s page, open the Test tab. It starts with a sample body. Under Headers, add x-github-event with a value such as push so the handler logs an event name, then choose Send event. The test is signed with the endpoint’s secret and runs the full delivery pipeline. Sending the same body again is deduplicated to the first delivery, so change the body to send another.The delivery appears on the Deliveries tab. Open it and check Targets to see that it reached the github-events subscriber, then follow the link to the run to see the logged event.Connect the real provider
To receive real events, register the endpoint’s Webhook URL and the same secret with the provider. Each provider page lists where to add them.Connect a provider
Register the URL and secret by hand or with an AI coding agent.
Filters
Run a subscriber only for the events it handles.

