Configurez votre intégration Datadog/Webhooks directement via l’API Datadog. Pour en savoir plus sur l’intégration Datadog/Webhooks, consultez la page dédiée à l’intégration.
POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variableshttps://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables
Crée un endpoint avec le nom <NOM_VARIABLE_PERSONNALISÉE>
.
Corps de requête pour la définition d’une variable personnalisée.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
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/webhooks/configuration/custom-variables" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
EOF
POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhookshttps://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks
Crée un endpoint <NOM_WEBHOOK>
.
Corps de requête pour la création d’une intégration Webhooks.
Champ
Type
Description
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
OK
Datadog-Webhooks integration.
Champ
Type
Description
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
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/webhooks/configuration/webhooks" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
"name": "WEBHOOK_NAME",
"url": "https://example.com/webhook"
}
EOF
DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
Supprime l’endpoint <NOM_VARIABLE_PERSONNALISÉE>
.
Nom
Type
Description
custom_variable_name [required]
string
The name of the custom variable.
OK
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export custom_variable_name="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
Supprime l’endpoint <NOM_WEBHOOK>
.
Nom
Type
Description
webhook_name [required]
string
The name of the webhook.
OK
Authentication error
Error response object.
{
"errors": [
"Bad Request"
]
}
Item Not Found
Error response object.
{
"errors": [
"Bad Request"
]
}
# Path parameters
export webhook_name="CHANGE_ME"
# Curl command
curl -X DELETE "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_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/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
Affiche le contenu de la variable personnalisée <NOM_VARIABLE_PERSONNALISÉE>
. Si la variable personnalisée est secrète, renvoie null
pour <NOM_VARIABLE_PERSONNALISÉE>
dans la charge utile de la réponse.
Nom
Type
Description
custom_variable_name [required]
string
The name of the custom variable.
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
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 custom_variable_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_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/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
Récupère le contenu du Webhook <NOM_WEBHOOK>
.
Nom
Type
Description
webhook_name [required]
string
The name of the webhook.
OK
Datadog-Webhooks integration.
Champ
Type
Description
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
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 webhook_name="CHANGE_ME"
# Curl command
curl -X GET "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_name}" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"
PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}
Met à jour l’endpoint <CUSTOM_VARIABLE_NAME>
.
Nom
Type
Description
custom_variable_name [required]
string
The name of the custom variable.
Corps de requête pour la mise à jour d’une variable personnalisée existante.
{
"is_secret": false,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
OK
Custom variable for Webhook integration.
{
"is_secret": true,
"name": "CUSTOM_VARIABLE_NAME",
"value": "CUSTOM_VARIABLE_VALUE"
}
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 custom_variable_name="CHANGE_ME"
# Curl command
curl -X PUT "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/${custom_variable_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
PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}
Met à jour l’endpoint <NOM_WEBHOOK>
.
Nom
Type
Description
webhook_name [required]
string
The name of the webhook.
Mettez à jour une intégration Datadog/Webhooks existante.
Champ
Type
Description
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
OK
Datadog-Webhooks integration.
Champ
Type
Description
custom_headers
object
If null
, uses no header.
If given a JSON payload, these will be headers attached to your webhook.
<any-key>
string
Additional properties for custom headers.
encode_as
enum
Encoding type. Can be given either json
or form
.
Allowed enum values: json,form
name [required]
string
The name of the webhook. It corresponds with <WEBHOOK_NAME>
.
Learn more on how to use it in
monitor notifications.
payload
object
If null
, uses the default payload.
If given a JSON payload, the webhook returns the payload
specified by the given payload.
Webhooks variable usage.
url [required]
string
URL of the webhook.
{
"custom_headers": {
"<any-key>": "string"
},
"encode_as": "string",
"name": "WEBHOOK_NAME",
"payload": {},
"url": "https://example.com/webhook"
}
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 webhook_name="CHANGE_ME"
# Curl command
curl -X PUT "https://api.datadoghq.eu"https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/${webhook_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