Configure your Datadog-Slack integration directly through the Datadog API.
PUT https://api.datadoghq.eu/api/v1/integration/slackhttps://api.datadoghq.com/api/v1/integration/slack
Add channels to your existing Datadog-Slack integration.
This method updates your integration configuration by replacing your current configuration with the new one sent to your Datadog organization.
Update an existing Datadog-Slack integration request body.
Field
Type
Description
channels
[object]
An array of slack channel configurations.
account [required]
string
Account to which the channel belongs to.
channel_name [required]
string
Your channel name.
transfer_all_user_comments
boolean
To be notified for every comment on a graph, set it to true
.
If set to False
use the @slack-channel_name
syntax for comments
to be posted to slack.
{
"channels": [
{
"account": "jane.doe",
"channel_name": "#general",
"transfer_all_user_comments": false
}
]
}
OK
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X PUT "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
"channels": [
{
"account": "jane.doe",
"channel_name": "#general"
}
]
}
EOF
POST https://api.datadoghq.eu/api/v1/integration/slackhttps://api.datadoghq.com/api/v1/integration/slack
Create a Datadog-Slack integration. Once created, add a channel to it with the Add channels to Slack integration endpoint.
This method updates your integration configuration by adding your new configuration to the existing one in your Datadog organization.
Create Datadog-Slack integration request body.
Field
Type
Description
service_hooks
[object]
The array of service hook objects.
account [required]
string
Your Slack account name.
url [required]
string
Your Slack service hook URL.
{
"service_hooks": [
{
"account": "joe.doe",
"url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
}
]
}
OK
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X POST "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
"service_hooks": [
{
"account": "joe.doe",
"url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
}
]
}
EOF
require 'rubygems'
require 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
config= {
"service_hooks": [
{
"account": "Main_Account",
"url": "https://hooks.slack.com/services/1/1/1"
},
{
"account": "doghouse",
"url": "https://hooks.slack.com/services/2/2/2"
}
]
}
dog = Dogapi::Client.new(api_key, app_key)
dog.create_integration('slack', config)
POST https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{team_name}/channelshttps://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{team_name}/channels
Add a channel to your Datadog-Slack integration.
Name
Type
Description
team_name [required]
string
Your Slack team name.
Payload describing Slack channel to be created
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
OK
The Slack channel configuration.
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export team_name="CHANGE_ME"
# Curl command
curl -X POST "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/${team_name}/channels" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{}
EOF
DELETE https://api.datadoghq.eu/api/v1/integration/slackhttps://api.datadoghq.com/api/v1/integration/slack
Delete a Datadog-Slack integration.
OK
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
require 'rubygems'
require 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
dog.delete_integration('slack')
GET https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}
Get a channel configured for your Datadog-Slack integration.
Name
Type
Description
team_name [required]
string
Your Slack team name.
channel_name [required]
string
The name of the Slack channel being operated on.
OK
The Slack channel configuration.
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export team_name="CHANGE_ME"
export channel_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/${team_name}/channels/${channel_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
GET https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{team_name}/channelshttps://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{team_name}/channels
Get a list of all channels configured for your Datadog-Slack integration.
Name
Type
Description
team_name [required]
string
Your Slack team name.
OK
A list of configured Slack channels.
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export team_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/${team_name}/channels" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
GET https://api.datadoghq.eu/api/v1/integration/slackhttps://api.datadoghq.com/api/v1/integration/slack
Get all information about your Datadog-Slack integration.
OK
{}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
require 'rubygems'
require 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
dog = Dogapi::Client.new(api_key, app_key)
dog.get_integration('slack')
DELETE https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}
Remove a channel from your Datadog-Slack integration.
Name
Type
Description
team_name [required]
string
Your Slack team name.
channel_name [required]
string
The name of the Slack channel being operated on.
The channel was removed successfully.
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export team_name="CHANGE_ME"
export channel_name="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/${team_name}/channels/${channel_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
PATCH https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{team_name}/channels/{channel_name}
Update a channel used in your Datadog-Slack integration.
Name
Type
Description
team_name [required]
string
Your Slack team name.
channel_name [required]
string
The name of the Slack channel being operated on.
Payload describing fields and values to be updated.
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
OK
The Slack channel configuration.
Field
Type
Description
display
object
Configuration options for what is shown in an alert event message.
message
boolean
Show the main body of the alert event.
notified
boolean
Show the list of @-handles in the alert event.
snapshot
boolean
Show the alert event's snapshot image.
tags
boolean
Show the scopes on which the monitor alerted.
name
string
Your channel name.
{
"display": {
"message": false,
"notified": false,
"snapshot": false,
"tags": false
},
"name": "#general"
}
Bad Request
Error response object.
{
"errors": [
"Bad Request"
]
}
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export team_name="CHANGE_ME"
export channel_name="CHANGE_ME"
# Curl command
curl -X PATCH "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/${team_name}/channels/${channel_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{}
EOF