Incoming webhooks let you programmatically create items in Onset by sending a simple HTTP POST request. You can use them to create releases, milestones, or subscribers.
When you create an incoming webhook, Onset generates a unique URL that accepts a JSON payload. Each payload follows the same structure as the Onset API schema and includes the relevant fields for the target item type.
There are three types of incoming webhooks:
- Release – create a new release entry with title, version, description, and related metadata.
- Milestone – create a milestone in your roadmap.
- Subscriber – add a new subscriber to your list.
Your webhook URL contains a secret token. Treat it like a password — do not
share or expose it publicly (e.g., in version control, client-side code, or
logs).
