Create a new Opsgenie account

POST https://api.ap1.datadoghq.com/api/v2/integration/opsgenie/accountshttps://api.ap2.datadoghq.com/api/v2/integration/opsgenie/accountshttps://api.datadoghq.eu/api/v2/integration/opsgenie/accountshttps://api.ddog-gov.com/api/v2/integration/opsgenie/accountshttps://api.us2.ddog-gov.com/api/v2/integration/opsgenie/accountshttps://api.datadoghq.com/api/v2/integration/opsgenie/accountshttps://api.us3.datadoghq.com/api/v2/integration/opsgenie/accountshttps://api.us5.datadoghq.com/api/v2/integration/opsgenie/accounts

Overview

Create a new Opsgenie account in the Datadog Opsgenie integration. This endpoint requires the manage_integrations permission.

Request

Body Data (required)

Opsgenie account payload.

Expand All

Field

Type

Description

data [required]

object

Opsgenie account data for a create request.

attributes [required]

object

The Opsgenie account attributes for a create request.

api_key [required]

string

The Opsgenie API key for your Opsgenie account.

region [required]

enum

The region for the Opsgenie service. Allowed enum values: us,eu,custom

type [required]

enum

Opsgenie account resource type. Allowed enum values: opsgenie-account

default: opsgenie-account

{
  "data": {
    "attributes": {
      "api_key": "00000000-0000-0000-0000-000000000000",
      "region": "us"
    },
    "type": "opsgenie-account"
  }
}

Response

CREATED

Response containing an Opsgenie account.

Expand All

Field

Type

Description

data [required]

object

Opsgenie account data from a response.

attributes [required]

object

The attributes from an Opsgenie account response.

region

enum

The region for the Opsgenie service. Allowed enum values: us,eu,custom

id [required]

string

The ID of the Opsgenie account.

type [required]

enum

Opsgenie account resource type. Allowed enum values: opsgenie-account

default: opsgenie-account

{
  "data": {
    "attributes": {
      "region": "us"
    },
    "id": "596da4af-0563-4097-90ff-07230c3f9db3",
    "type": "opsgenie-account"
  }
}

Bad Request

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Forbidden

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  ## default
# 

# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/integration/opsgenie/accounts" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "data": { "attributes": { "api_key": "00000000-0000-0000-0000-000000000000", "region": "us" }, "type": "opsgenie-account" } } EOF