Custom Triggers
A Custom Trigger is a scheduled, signed HTTP POST to a URL you own — set up entirely in the dashboard. Reach for one when you want cron-like automation that calls an endpoint on a schedule.
Note
Dashboard-only. Triggers are created and managed from the Triggers page in the dashboard — there's no SDK or producer code to write in your app.
When to use one#
| Use a trigger | Use SDK code |
|---|---|
| Call a public endpoint on a cron or interval. | You need producer code or business logic before enqueue. |
| An operator should pause, fire, or delete it from the dashboard. | A Next.js app that should run a Worker processor. |
Create a trigger#
- Open the dashboard and go to Triggers.
- Enter a name and the target URL (
httporhttps). - Choose a cron pattern or a fixed interval.
- Set the JSON payload, plus optional retries and backoff.
What your endpoint receives#
On each fire, NextMQ sends a POST whose body is exactly the JSON payload you configured. Any 2xx response counts as success; the body of your response is ignored. A non-2xx (or an unreachable endpoint) is a failure and retries if you enabled retries.
request body
{ "source": "trigger", "report": "daily" }Note
Requests are signed with
x-nextmq-signature and x-nextmq-timestamp. Verifying is optional — if you want to confirm a call came from NextMQ, check the HMAC with the webhook secret from your connection string.