In Flashduty On-call
- In the Flashduty console, go to Integration Center → Change Events
- Select Unleash and enter an integration name
- To send changes to a specific channel, add rules in the integration’s Route on labels such as
project,environmentandflag - Click Save and copy the generated push URL
Configure in Unleash
1
Create a webhook integration
- Open the Unleash admin UI and go to Integrations
- On the Webhook card, click New integration
2
Enter the push URL
- Webhook URL: paste the full push URL from the Flashduty integration
- Content-Type: keep the default
application/json - Authorization and Extra HTTP Headers: leave empty; Flashduty authenticates with the
integration_keyin the push URL - Body template: leave empty. With no template Unleash sends the full event JSON, which is the format Flashduty parses
3
Select events and scope
- Events: select the events below; other events are ignored
feature-created,feature-updated,feature-archived,feature-revivedfeature-environment-enabled,feature-environment-disabledfeature-strategy-add,feature-strategy-update,feature-strategy-removefeature-variants-updated
- Projects and Environments: leave empty for all, or select only the scope you care about, such as production
- Click Save
What one change is
Event
id increments within one Unleash instance. Create one integration per Unleash instance: if several instances share an integration, events with the same id are treated as the same change.
Status mapping
These deliveries return success but create no change:
- Change request events such as
change-request-created,change-request-approvedandchange-request-applied. When a change request is applied, Unleash sends one of the events in the table above for each flag change in it, and those are recorded - Events that do not alter how a flag evaluates: tags, stale markers, description and type, project moves
- Events about other resources (projects, environments, users, segments) and deliveries without a
type
Change content
Labels for routing and for filtering the change list:
FAQ
Does an Unleash retry record a duplicate?
Does an Unleash retry record a duplicate?
No. When a delivery fails (a 50x or a network error) Unleash retries once with the same content, and Flashduty records it once. Unleash does not guarantee delivery order; Flashduty uses the event’s own time (
createdAt) as the change time.Why are change request notifications not recorded?
Why are change request notifications not recorded?
A change request does not alter production behavior until it is applied. On apply, Unleash sends the matching
feature-* event for each flag change in it, and Flashduty records those events.The push returns an InvalidParameter error?
The push returns an InvalidParameter error?
id is missing,featureName is missing: the body is incomplete. Make sure Body template is emptyinvalid createdAt: the event time is not in a valid format- Body is not JSON: make sure Content-Type is
application/jsonand that any Body template renders valid JSON