OpsGenie

URL Format

opsgenie://[host:port/]apikey

URL Fields

• Host - The OpsGenie API host. Use 'api.eu.opsgenie.com' for EU instances
  Default: api.opsgenie.com
  URL part: opsgenie://host:port/apikey

• Port - The OpsGenie API port.
  Default: 443
  URL part: opsgenie://host:port/apikey

• APIKey - The OpsGenie API key (Required)
  URL part: opsgenie://host:port/apikey

Query/Param Props

Props can be supplied through URL query params: ?key=value&key=value etc.

• Actions - Custom actions that will be available for the alert
  Default: empty

• Alias - Client-defined identifier of the alert
  Default: empty

• Description - Description field of the alert
  Default: empty

• Entity - Entity field of the alert that is generally used to specify which domain the Source field of the alert
  Default: empty

• Note - Additional note that will be added while creating the alert
  Default: empty

• Priority - Priority level of the alert. Possible values are P1, P2, P3, P4 and P5
  Default: empty

• Responders - Teams, users, escalations and schedules that the alert will be routed to send notifications
  Default: empty

• Source - Source field of the alert
  Default: empty

• Tags - Tags of the alert
  Default: empty

• User - Display name of the request owner
  Default: empty

• VisibleTo - Teams and users that the alert will become visible to without sending any notification
  Default: empty

Creating a REST API endpoint in OpsGenie

1. Open up the Integration List page by clicking on Settings => Integration List within the menu

2. Click API => Add

3. Make sure Create and Update Access and Enabled are checked and click Save Integration

4. Copy the API Key

5. Format the service URL

The host can be either api.opsgenie.com or api.eu.opsgenie.com depending on the location of your instance. See the OpsGenie documentation for details.

opsgenie://api.opsgenie.com/eb243592-faa2-4ba2-a551q-1afdf565c889
                            └───────────────────────────────────┘
                                           token

Example

opsgenie://api.opsgenie.com/eb243592-faa2-4ba2-a551q-1afdf565c889?alias=Life+is+too+short+for+no+alias&description=Every+alert+needs+a+description&actions=An+action&tags=["tag1","tag2"]&entity=An+example+entity&source=The+source&priority=P1&user=Dracula¬e=Here+is+a+note