> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Alert

Create a new alert.

<Note>
  External Documentation

  To learn more, visit the [Rootly documentation](https://docs.rootly.com/api-reference/alerts/creates-an-alert).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter                | Description                                                                                                                                                                                                                                |
  | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Alert Urgency ID         | The ID of the alert urgency to assign to the alert.                                                                                                                                                                                        |
  | Description              | The description of the alert.                                                                                                                                                                                                              |
  | Group IDs                | A comma-separated list of the group IDs to attach to the alert.                                                                                                                                                                            |
  | Noise                    | Select whether the alert is marked as noise.                                                                                                                                                                                               |
  | Notification Target ID   | The identifier of the notification target object to page.<br /><br />**Note**: Only available for organizations with Rootly On-Call enabled.                                                                                               |
  | Notification Target Type | Select the type of the notification target to page.<br /><br />**Note**: Only available for organizations with Rootly On-Call enabled. Contact Rootly support if you encounter issues using `Functionality` as a notification target type. |
  | Service IDs              | A comma-separated list of the service IDs to attach to the alert.                                                                                                                                                                          |
  | Status                   | Select the status to create the alert with.<br /><br />**Note**: Only available for organizations with Rootly On-Call enabled.                                                                                                             |
  | Summary                  | The summary of the alert.                                                                                                                                                                                                                  |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
  | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Alert Field Values   | The custom alert field values to set on the alert.<br /><br />**For example:**<br /><pre><code>\[<br />  \{<br />  "alert\_field\_id": "1a2b3c",<br />  "value": "Database"<br />  }<br />]</code></pre>                                                                                                                                                                                                                                                                                                                                                     |
  | Data                 | The additional data to attach to the alert, as a JSON object.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | Deduplication Key    | The deduplication key of the alert. Alerts sharing the same deduplication key are treated as a single alert.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | Ended At             | The date and time the alert ended at.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | Environment IDs      | A comma-separated list of the environment IDs to attach to the alert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | External ID          | The ID of the alert in the external system it originated from.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
  | External URL         | The URL of the alert in the external system it originated from.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Functionality IDs    | A comma-separated list of the functionality IDs to attach to the alert.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
  | Labels               | The labels to attach to the alert, as a list of key-value objects.<br /><br />**For example:**<br /><pre><code>\[<br />  \{<br />  "key": "cluster",<br />  "value": "prod"<br />  }<br />]</code></pre>                                                                                                                                                                                                                                                                                                                                                     |
  | Notification Targets | The notification targets to page, as any combination of `User`, `Group`, `EscalationPolicy`, `Service`, and `Functionality` targets. When provided, this takes precedence over the `Notification Target Type` and `Notification Target ID` parameters.<br /><br />**For example:**<br /><pre><code>\[<br />  \{<br />  "type": "Group",<br />  "id": "1a2b3c"<br />  }<br />]</code></pre>**Note**: Only available for organizations with Rootly On-Call enabled. `Functionality` targets require the `enable_paging_functionalities` feature to be enabled. |
  | Started At           | The date and time the alert started at.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
</div>

## Example Output

```json theme={"dark"}
{
	"data": {
		"id": "<string>",
		"type": "alerts",
		"attributes": {
			"short_id": "<string>",
			"source": "<string>",
			"summary": "<string>",
			"created_at": "<string>",
			"updated_at": "<string>",
			"noise": "noise",
			"status": "open",
			"description": "<string>",
			"services": [
				{
					"name": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"slug": "<string>",
					"managed_by": "web",
					"description": "<string>",
					"public_description": "<string>",
					"notify_emails": [
						"<string>"
					],
					"color": "<string>",
					"position": 123,
					"backstage_id": "<string>",
					"external_id": "<string>",
					"pagerduty_id": "<string>",
					"opsgenie_id": "<string>",
					"cortex_id": "<string>",
					"service_now_ci_sys_id": "<string>",
					"github_repository_name": "<string>",
					"github_repository_branch": "<string>",
					"gitlab_repository_name": "<string>",
					"gitlab_repository_branch": "<string>",
					"kubernetes_deployment_name": "<string>",
					"environment_ids": [
						"<string>"
					],
					"service_ids": [
						"<string>"
					],
					"owner_group_ids": [
						"<string>"
					],
					"owner_user_ids": [
						123
					],
					"alert_urgency_id": "<string>",
					"escalation_policy_id": "<string>",
					"alerts_email_enabled": true,
					"alerts_email_address": "<string>",
					"slack_channels": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"slack_aliases": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"alert_broadcast_enabled": true,
					"alert_broadcast_channel": {
						"id": "<string>",
						"name": "<string>"
					},
					"incident_broadcast_enabled": true,
					"incident_broadcast_channel": {
						"id": "<string>",
						"name": "<string>"
					},
					"properties": [
						{
							"catalog_property_id": "<string>",
							"value": "<string>"
						}
					]
				}
			],
			"groups": [
				{
					"name": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"slug": "<string>",
					"managed_by": "web",
					"description": "<string>",
					"public_description": "<string>",
					"notify_emails": [
						"<string>"
					],
					"color": "<string>",
					"position": 123,
					"backstage_id": "<string>",
					"external_id": "<string>",
					"pagerduty_id": "<string>",
					"pagerduty_service_id": "<string>",
					"opsgenie_id": "<string>",
					"victor_ops_id": "<string>",
					"pagertree_id": "<string>",
					"cortex_id": "<string>",
					"service_now_ci_sys_id": "<string>",
					"user_ids": [
						123
					],
					"admin_ids": [
						123
					],
					"alerts_email_enabled": true,
					"alerts_email_address": "<string>",
					"alert_urgency_id": "<string>",
					"slack_channels": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"slack_aliases": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"alert_broadcast_enabled": true,
					"alert_broadcast_channel": {
						"id": "<string>",
						"name": "<string>"
					},
					"incident_broadcast_enabled": true,
					"incident_broadcast_channel": {
						"id": "<string>",
						"name": "<string>"
					},
					"auto_add_members_when_attached": true,
					"auto_add_members_scope": "off",
					"properties": [
						{
							"catalog_property_id": "<string>",
							"value": "<string>"
						}
					]
				}
			],
			"functionalities": [
				{
					"name": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"slug": "<string>",
					"managed_by": "web",
					"description": "<string>",
					"public_description": "<string>",
					"notify_emails": [
						"<string>"
					],
					"color": "<string>",
					"backstage_id": "<string>",
					"external_id": "<string>",
					"pagerduty_id": "<string>",
					"opsgenie_id": "<string>",
					"opsgenie_team_id": "<string>",
					"cortex_id": "<string>",
					"service_now_ci_sys_id": "<string>",
					"position": 123,
					"environment_ids": [
						"<string>"
					],
					"service_ids": [
						"<string>"
					],
					"owner_group_ids": [
						"<string>"
					],
					"owner_user_ids": [
						123
					],
					"escalation_policy_id": "<string>",
					"slack_channels": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"slack_aliases": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"properties": [
						{
							"catalog_property_id": "<string>",
							"value": "<string>"
						}
					]
				}
			],
			"environments": [
				{
					"name": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"slug": "<string>",
					"managed_by": "web",
					"external_id": "<string>",
					"description": "<string>",
					"public_description": "<string>",
					"notify_emails": [
						"<string>"
					],
					"color": "<string>",
					"position": 123,
					"slack_channels": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"slack_aliases": [
						{
							"id": "<string>",
							"name": "<string>"
						}
					],
					"properties": [
						{
							"catalog_property_id": "<string>",
							"value": "<string>"
						}
					]
				}
			],
			"service_ids": [
				"<string>"
			],
			"group_ids": [
				"<string>"
			],
			"functionality_ids": [
				"<string>"
			],
			"environment_ids": [
				"<string>"
			],
			"external_id": "<string>",
			"external_url": "<string>",
			"alert_urgency_id": "<string>",
			"alert_urgency": {
				"name": "<string>",
				"description": "<string>",
				"position": 123,
				"created_at": "<string>",
				"updated_at": "<string>",
				"id": "<string>",
				"retrigger_timeout_minutes": 123,
				"urgency": "<string>",
				"color": "<string>",
				"team_id": 123,
				"deleted_at": "<string>"
			},
			"group_leader_alert_id": "<string>",
			"is_group_leader_alert": true,
			"labels": [
				{
					"key": "<string>",
					"value": "<string>"
				}
			],
			"data": {},
			"notification_target_type": "User",
			"notification_target_id": "<string>",
			"deduplication_key": "<string>",
			"alert_field_values": [
				{
					"id": "<string>",
					"value": "<string>",
					"alert_field_id": "<string>",
					"alert_id": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>"
				}
			],
			"responders": [
				{
					"id": 123,
					"email": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"name": "<string>",
					"phone": "<string>",
					"phone_2": "<string>",
					"first_name": "<string>",
					"last_name": "<string>",
					"preferred_name": "<string>",
					"full_name": "<string>",
					"full_name_with_team": "<string>",
					"slack_id": "<string>",
					"time_zone": "<string>"
				}
			],
			"notified_users": [
				{
					"email": "<string>",
					"created_at": "<string>",
					"updated_at": "<string>",
					"first_name": "<string>",
					"last_name": "<string>",
					"full_name": "<string>",
					"full_name_with_team": "<string>",
					"time_zone": "<string>"
				}
			],
			"alerting_targets": [
				{
					"id": "<string>",
					"type": "<string>"
				}
			],
			"url": "<string>",
			"started_at": "2023-11-07T05:31:56Z",
			"ended_at": "2023-11-07T05:31:56Z"
		},
		"source": "<string>"
	},
	"included": [
		{
			"id": "<string>",
			"type": "<string>",
			"attributes": {},
			"relationships": {}
		}
	]
}
```

## Workflow Library Example

[Create Alert with Rootly and Send Results Via Email](https://library.blinkops.com/workflows/create-alert-with-rootly-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-alert-with-rootly-and-send-results-via-email/canvas" />
</div>