Navigation

Get the Configuration of a Third-Party Service Integration

Info With Circle IconCreated with Sketch.Note

Groups and projects are synonymous terms. Your {GROUP-ID} is the same as your project ID. For existing groups, your group/project ID remains the same. The resource and corresponding endpoints use the term groups.

https://cloud.mongodb.com/api/atlas/v1.0

GET /api/atlas/v1.0/groups/{GROUP-ID}/integrations/{INTEGRATION-TYPE}
ParameterRequired/OptionalDescription
{GROUP-ID}RequiredProject identifier.
{INTEGRATION-TYPE}Required

Third-party service integration identifier. Accepted values are:

  • PAGER_DUTY
  • SLACK
  • DATADOG
  • NEW_RELIC
  • OPS_GENIE
  • VICTOR_OPS
  • FLOWDOCK
  • WEBHOOK

The following query parameters are optional:

NameTypeNecessityDescriptionDefault
pageNumintegerOptionalPage number, starting with one, that Atlas returns of the total number of objects.1
itemsPerPageintegerOptionalNumber of items that Atlas returns per page, up to a maximum of 500.100
includeCountbooleanOptionalFlag that indicates whether Atlas returns the totalCount parameter in the response body.true
prettybooleanOptionalFlag that indicates whether Atlas returns the JSON response in the prettyprint format.false
envelopebooleanOptional

Flag that indicates whether Atlas wraps the response in an envelope.

Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query.

Endpoints that return a list of results use the results object as an envelope. Atlas adds the status parameter to the response body.

false

This endpoint does not use HTTP request body parameters.

The response returns the specified third-party integration configuration object if that service has been configured. If it has not been configured, the response will return an INTEGRATION_NOT_CONFIGURED error.

Each third-party integration configuration object includes a type property equal to its own integration type (e.g. "type": "PAGER_DUTY"). Additionally, each third-party service configuration object provides details specific to that service. The following lists the properties returned for each third-party service configuration object:

ServiceResult
PagerDuty

A returned PagerDuty integration configuration object will contain the following fields:

PropertyDescription
typePAGER_DUTY
serviceKeyYour Service Key.
Slack

A returned Slack integration configuration object will contain the following fields:

PropertyDescription
typeSLACK
apiTokenYour API Token.
teamNameYour team name. This field may not be present with a legacy Slack integration.
channelNameThe configured Slack channel name. An empty string if the value is not set.
Datadog

A returned Datadog integration configuration object will contain the following fields:

PropertyDescription
typeDATADOG
apiKeyYour API Key.
regionIndicates which API URL is used, either US or EU. Datadog will use US by default.
New Relic

A returned New Relic integration configuration object will contain the following fields:

PropertyDescription
typeNEW_RELIC
licenseKeyYour License Key.
accountIdUnique identifier of your New Relic account.
writeTokenYour Insights Insert Key.
readTokenYour Insights Query Key.
Opsgenie

A returned Opsgenie integration configuration object will contain the following fields:

PropertyDescription
typeOPS_GENIE
apiKeyYour API Key.
regionIndicates which API URL is used, either US or EU. Opsgenie will use US by default.
VictorOps

A returned VictorOps integration configuration object will contain the following fields:

PropertyDescription
typeVICTOR_OPS
apiKeyYour API Key.

The configuration object may also contain the following fields, depending on your configuration:

PropertyDescription
routingKeyAn optional field returned if you have a Routing Key configured.
Flowdock

A returned Flowdock integration configuration object will contain the following fields:

PropertyDescription
typeFLOWDOCK
flowNameYour Flowdock Flow name.
apiTokenYour API Token.
orgNameYour Flowdock organization name.
Webhook Settings

A returned webhook configuration object will contain the following fields:

PropertyDescription
typeWEBHOOK
urlYour webhook URL.

The configuration object may also contain the following fields, depending on your configuration:

PropertyDescription
secretAn optional field returned if your webhook is configured with a secret.
curl -X GET -u "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest "https://cloud.mongodb.com/api/atlas/v1.0/groups/5d791c84ff7a2522cc4f9aa1/integrations/DATADOG"
{
"apiKey": "112233",
"region": "US",
"type": "DATADOG"
}
Give Feedback