---
title: Webhooks Integration
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Webhooks Integration
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Webhooks Integration

Configure your Datadog-Webhooks integration directly through the Datadog API. See the [Webhooks integration page](https://docs.datadoghq.com/integrations/webhooks.md) for more information.

## [Create a webhooks integration →](https://docs.datadoghq.com/api/latest/webhooks-integration/create-a-webhooks-integration.md){% #create-a-webhooks-integration %}

| Datadog site      | API endpoint                                                                          |
| ----------------- | ------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks |

## [Get all auth methods →](https://docs.datadoghq.com/api/latest/webhooks-integration/get-all-auth-methods.md){% #get-all-auth-methods %}

| Datadog site      | API endpoint                                                                            |
| ----------------- | --------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/integration/webhooks/configuration/auth-method      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method |

## [Create an OAuth2 client credentials auth method →](https://docs.datadoghq.com/api/latest/webhooks-integration/create-an-oauth2-client-credentials-auth-method.md){% #create-an-oauth2-client-credentials-auth-method %}

| Datadog site      | API endpoint                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials |

## [Get a webhook integration →](https://docs.datadoghq.com/api/latest/webhooks-integration/get-a-webhook-integration.md){% #get-a-webhook-integration %}

| Datadog site      | API endpoint                                                                                        |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |

## [Get an OAuth2 client credentials auth method →](https://docs.datadoghq.com/api/latest/webhooks-integration/get-an-oauth2-client-credentials-auth-method.md){% #get-an-oauth2-client-credentials-auth-method %}

| Datadog site      | API endpoint                                                                                                                       |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |

## [Update a webhook →](https://docs.datadoghq.com/api/latest/webhooks-integration/update-a-webhook.md){% #update-a-webhook %}

| Datadog site      | API endpoint                                                                                        |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |

## [Delete a webhook →](https://docs.datadoghq.com/api/latest/webhooks-integration/delete-a-webhook.md){% #delete-a-webhook %}

| Datadog site      | API endpoint                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/webhooks/{webhook_name} |

## [Update an OAuth2 client credentials auth method →](https://docs.datadoghq.com/api/latest/webhooks-integration/update-an-oauth2-client-credentials-auth-method.md){% #update-an-oauth2-client-credentials-auth-method %}

| Datadog site      | API endpoint                                                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |

## [Create a custom variable →](https://docs.datadoghq.com/api/latest/webhooks-integration/create-a-custom-variable.md){% #create-a-custom-variable %}

| Datadog site      | API endpoint                                                                                  |
| ----------------- | --------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables |

## [Delete an OAuth2 client credentials auth method →](https://docs.datadoghq.com/api/latest/webhooks-integration/delete-an-oauth2-client-credentials-auth-method.md){% #delete-an-oauth2-client-credentials-auth-method %}

| Datadog site      | API endpoint                                                                                                                          |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/integration/webhooks/configuration/auth-method/oauth2-client-credentials/{auth_method_id} |

## [Get a custom variable →](https://docs.datadoghq.com/api/latest/webhooks-integration/get-a-custom-variable.md){% #get-a-custom-variable %}

| Datadog site      | API endpoint                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |

## [Update a custom variable →](https://docs.datadoghq.com/api/latest/webhooks-integration/update-a-custom-variable.md){% #update-a-custom-variable %}

| Datadog site      | API endpoint                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |

## [Delete a custom variable →](https://docs.datadoghq.com/api/latest/webhooks-integration/delete-a-custom-variable.md){% #delete-a-custom-variable %}

| Datadog site      | API endpoint                                                                                                           |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/integration/webhooks/configuration/custom-variables/{custom_variable_name} |