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

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

Unique name of the alert source

Example:

"Production Web Dashboard Alerts"

source_type
enum<string>
required

Type of alert source

Available options:
alertmanager,
app_optics,
azure_monitor,
big_panda,
bugsnag,
checkly,
chronosphere,
cloudwatch,
cloudflare,
coralogix,
cronitor,
crowdstrike_falcon,
datadog,
dynatrace,
elasticsearch,
email,
expel,
github_issue,
google_cloud,
grafana,
heartbeat,
http,
http_custom,
honeycomb,
incoming_calls,
jira,
jsm,
monte_carlo,
nagios,
new_relic,
opsgenie,
prtg,
pager_duty,
panther,
pingdom,
runscope,
sns,
sentry,
sentry_metric,
service_now,
splunk,
status_cake,
status_page_views,
sumo_logic,
uptime,
vercel,
zendesk
Example:

"alertmanager"

template
object
required
Example:
auto_resolve_incident_alerts
boolean

Whether to auto-resolve incident alerts when the alert auto-resolves. Defaults to true. Only use in conjunction with auto_resolve_timeout_minutes.

Example:

false

auto_resolve_timeout_minutes
integer<int64>

When set, alerts from this source will automatically resolve after this many minutes.

Example:

1

email_options
object
Example:
heartbeat_options
object
Example:
http_custom_options
object
Example:
jira_options
object
Example:
owning_team_ids
string[]

IDs of teams that own this alert source

Example:

Response

200 - application/json

OK response.

alert_source
object
required