Skip to main content
POST
Create
🔑 Requires the alert_route.create scope.

Authorizations

Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Body

application/json
alert_sources
object[]
required

Which alert sources this route matches

Example:
condition_groups
object[]
required

Filter: the condition groups that must be true for this route to fire

Example:
enabled
boolean
required

Whether this alert route is enabled

Example:

false

escalation_config
object
required
Example:
expressions
object[]
required

The expressions used by bindings in this route

Example:
grouping_config
object
required
Example:
incident_config
object
required
Example:
is_private
boolean
required

Whether this alert route is private. Private alert routes only create private incidents from alerts.

Example:

false

message_config
object
required
Example:
name
string
required

The name of this alert route, for the user's reference

Example:

"Production incidents"

owning_team_ids
string[]

IDs of teams that own this alert route

Example:

Response

201 - application/json

Created response.

alert_route
object
required