Create Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow automations. Supports email, Slack, PagerDuty, Discord, and other notification actions.
Create Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow automations. Supports email, Slack, PagerDuty, Discord, and other notification actions.
Note: This API is currently in beta and may be subject to change. It is part of New Monitors and Alerts and may not be viewable in the legacy Alerts UI.
Invoke This Skill When
User asks to "create a Sentry alert" or "set up notifications"
User wants to be emailed or notified when issues match certain conditions
User mentions priority alerts, de-escalation alerts, or workflow automations
User wants to configure Slack, PagerDuty, or email notifications for Sentry issues
Prerequisites
curl available in shell
Sentry org auth token with alerts:write scope (also accepts org:admin or org:write)
Phase 1: Gather Configuration
Ask the user for any missing details:
Detail
Required
Example
Org slug
Yes
sentry, my-org
Auth token
Yes
sntryu_... (needs alerts:write scope)
Region
Yes (default: us)
us → us.sentry.io, de → de.sentry.io
Alert name
Yes
"High Priority De-escalation Alert"
Trigger events
Yes
Which issue events fire the workflow
Conditions
Optional
Filter conditions before actions execute
Action type
Yes
email, slack, or pagerduty
Action target
Yes
User email, team, channel, or service
Phase 2: Look Up IDs
Use these API calls to resolve names to IDs as needed.
API="https://{region}.sentry.io/api/0/organizations/{org}"
AUTH="Authorization: Bearer {token}"# Find user ID by email
curl -s "$API/members/" -H "$AUTH" | python3 -c "
import json,sys
for m in json.load(sys.stdin):
if m.get('email')=='USER_EMAIL' or m.get('user',{}).get('email')=='USER_EMAIL':
print(m['user']['id']); break"# List teams
curl -s "$API/teams/" -H "$AUTH" | python3 -c "
import json,sys
for t in json.load(sys.stdin):
print(t['id'], t['slug'])"# List integrations (for Slack/PagerDuty)
curl -s "$API/integrations/" -H "$AUTH" | python3 -c "
import json,sys
for i in json.load(sys.stdin):
print(i['id'], i['provider']['key'], i['name'])"
Phase 3: Build Payload
Trigger Events
Pick which issue events fire the workflow. Use logicType: "any-short" (triggers must always use this).
Type
Fires when
first_seen_event
New issue created
regression_event
Resolved issue recurs
reappeared_event
Archived issue reappears
issue_resolved_trigger
Issue is resolved
Filter Conditions
Conditions that must pass before actions execute. Use logicType: "all", "any-short", or "none".
The comparison field is polymorphic — its shape depends on the condition type:
