[TXP-77] Add webhook_config assets for webhook integrations (DataDog#23548)

moreauowen · goncalves-guilherme · claude · web-flow · commit c3c2e78d66ed · 2026-04-30T18:45:06.000Z
* [TXP-77] Add webhook_config.json and api-key-picker shortcode for batch 2 integrations

Adds webhook_config.json assets and {{&lt; integration-api-key-picker &gt;}} shortcode
to READMEs for: adyen, beyondtrust-identity-security-insights,
checkpoint-harmony-email-and-collaboration, contentful, intercom, jamf-pro,
postmark, and push-security.

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

* Remove orphaned integration tile link refs

The shortcode replacement in step 1 left unused `[N]: /integrations/...`
link references at the bottom of each README. Remove them.

* Renumber link refs after removing orphaned entries

* Use ### Webhook Configuration heading instead of nested #### under ### Configuration

Consolidates the Setup section structure so H4 headers render correctly
in the auto-generated config tab (single-source webhook tiles).

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Guilherme Goncalves &lt;guilherme.goncalves@datadoghq.com&gt;
Co-authored-by: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/adyen/README.md b/adyen/README.md
@@ -10,13 +10,11 @@ The Adyen integration collects transaction, dispute, and payout data using Adyen
 
 Follow the instructions below to configure this integration for your Adyen account.
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward Adyen events as logs to Datadog. For more details, see [Adyen webhook overview][2].
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Adyen integration tile][4].
+1. {{< integration-api-key-picker >}}
 2. Sign in to your [Adyen][1] account with a user which has a **Merchant technical integrator** role along with default roles, and has access to **Company account and all associated merchant accounts**.
 3. Under the **Developers** section, click **Webhooks**.
 4. Click on **Create new webhook**.
@@ -63,11 +61,10 @@ For further assistance, contact [Datadog Support][3].
 
 Additional helpful documentation, links, and articles:
 
-- [Monitor and optimize payment processing with Datadog's Adyen integration][5]
+- [Monitor and optimize payment processing with Datadog's Adyen integration][4]
 
 
 [1]: https://www.adyen.com/
 [2]: https://docs.adyen.com/development-resources/webhooks/
 [3]: https://docs.datadoghq.com/help/
-[4]: /integrations/adyen
-[5]: https://www.datadoghq.com/blog/monitor-adyen-payments/
+[4]: https://www.datadoghq.com/blog/monitor-adyen-payments/
diff --git a/adyen/assets/webhook_config.json b/adyen/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "adyen"}
diff --git a/beyondtrust_identity_security_insights/README.md b/beyondtrust_identity_security_insights/README.md
@@ -6,18 +6,16 @@
 
 Integrate BeyondTrust Identity Security Insights with Datadog's pre-built dashboard visualizations to gain insights into detection logs. With Datadog's built-in log pipelines, you can parse and enrich these logs to facilitate easy search and detailed insights.
 
-This integration also includes ready-to-use Cloud SIEM detection rules for enhanced monitoring and security. These Cloud SIEM rules can be used with [Datadog Workflow Automation][5] to orchestrate and automate your end-to-end processes with OOTB Workflow Blueprints.
+This integration also includes ready-to-use Cloud SIEM detection rules for enhanced monitoring and security. These Cloud SIEM rules can be used with [Datadog Workflow Automation][4] to orchestrate and automate your end-to-end processes with OOTB Workflow Blueprints.
 
 ## Setup
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward BeyondTrust Identity Security Insights detections as logs to Datadog.
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [BeyondTrust Identity Security Insights][2] tile.
-2. Sign in to [BeyondTrust Identity Security Insights Portal][3].
+1. {{< integration-api-key-picker >}}
+2. Sign in to [BeyondTrust Identity Security Insights Portal][2].
 3. Go to **Insights > Integrations** from the top left side main menu.
 4. Click **Webhooks**.
 5. Click **Create Integration**.
@@ -62,10 +60,9 @@ The BeyondTrust Identity Security Insights integration does not include any even
 
 ## Support
 
-For any further assistance, contact [Datadog support][4].
+For any further assistance, contact [Datadog support][3].
 
 [1]: https://www.beyondtrust.com/products/identity-security-insights
-[2]: /integrations/beyondtrust-identity-security-insights
-[3]: https://login.beyondtrust.io/signin/signIn
-[4]: https://docs.datadoghq.com/help/
-[5]: https://docs.datadoghq.com/actions/workflows/
+[2]: https://login.beyondtrust.io/signin/signIn
+[3]: https://docs.datadoghq.com/help/
+[4]: https://docs.datadoghq.com/actions/workflows/
diff --git a/beyondtrust_identity_security_insights/assets/webhook_config.json b/beyondtrust_identity_security_insights/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "beyond-trust-identity-security-insights"}
diff --git a/checkpoint_harmony_email_and_collaboration/README.md b/checkpoint_harmony_email_and_collaboration/README.md
@@ -12,14 +12,12 @@ Get detailed visibility into these events with out-of-the-box dashboards, and st
 
 Follow the instructions below to configure this integration for your Check Point Harmony Email & Collaboration account.
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward Check Point Harmony Email & Collaboration events as logs to Datadog.
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Check Point Harmony Email & Collaboration integration tile][4].
-2. Sign in to [Check Point Infinity Portal][5].
+1. {{< integration-api-key-picker >}}
+2. Sign in to [Check Point Infinity Portal][3].
 3. If you are not already in the **Harmony Email & Collaboration** Administrator Portal:
    - Click the **Menu** icon in the top-left corner.
    - In the **Harmony** section, click **Email & Collaboration**.
@@ -51,10 +49,8 @@ The Check Point Harmony Email & Collaboration integration does not include any e
 
 ## Troubleshooting
 
-Need help? Contact [Datadog support][3].
+Need help? Contact [Datadog support][2].
 
 [1]: https://www.checkpoint.com/harmony/email-security/
-[2]: https://app.datadoghq.com/account/settings/agent/latest
-[3]: https://docs.datadoghq.com/help/
-[4]: https://app.datadoghq.com/integrations/checkpoint_harmony_email_and_collaboration
-[5]: https://portal.checkpoint.com/
+[2]: https://docs.datadoghq.com/help/
+[3]: https://portal.checkpoint.com/
diff --git a/checkpoint_harmony_email_and_collaboration/assets/webhook_config.json b/checkpoint_harmony_email_and_collaboration/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "checkpoint-harmony-email-and-collaboration"}
diff --git a/contentful/README.md b/contentful/README.md
@@ -15,7 +15,7 @@ Follow the instructions below to configure this integration for your Contentful
 #### Webhook Configuration
 Configure the Datadog endpoint to forward Contentful events as logs to Datadog. See [Contentful Webhook overview][2] for more details.
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Contentful integration tile][5].
+1. {{< integration-api-key-picker >}}
 2. Log in to your [Contentful account][3] as space admin.
 3. Go to **Settings > Webhooks**.
 4. Click on **Add Webhook**.
@@ -63,4 +63,3 @@ Need help? Contact [Datadog support][4].
 [2]: https://www.contentful.com/developers/docs/webhooks/overview/
 [3]: https://be.contentful.com/login/
 [4]: https://docs.datadoghq.com/help/
-[5]: /integrations/contentful
diff --git a/contentful/assets/webhook_config.json b/contentful/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "contentful"}
diff --git a/intercom/README.md b/intercom/README.md
@@ -4,21 +4,19 @@
 
 [Intercom][1] is a customer communication platform that enables businesses to engage with their users through in-app messaging, email, and chat. It offers features like live chat, automated messaging, and customer support tools, making it easier for companies to provide personalized customer experiences.
 
-The Intercom integration seamlessly collects admin activities, data events, conversations, news items, and ticket data, and ingests them into Datadog for comprehensive analysis using [webhooks][6].
+The Intercom integration seamlessly collects admin activities, data events, conversations, news items, and ticket data, and ingests them into Datadog for comprehensive analysis using [webhooks][5].
 
 **Minimum Agent version:** 7.57.1
 
 ## Setup
 
 Follow the instructions below to configure this integration for your Intercom account.
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward Intercom events as logs to Datadog. See [Intercom webhook overview][3] for more details.
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Intercom integration tile][4].
+1. {{< integration-api-key-picker >}}
 2. Sign in to your [Intercom][2] account using a user account with full access to Apps and Integrations.
 3. Go to **Settings**.
 4. In the Integrations section, select **Developer Hub**.
@@ -78,11 +76,10 @@ The Intercom integration does not include any service checks.
 
 ## Support
 
-For further assistance, contact [Datadog Support][5].
+For further assistance, contact [Datadog Support][4].
 
 [1]: https://www.intercom.com/
 [2]: https://app.intercom.com/
 [3]: https://developers.intercom.com/docs/webhooks
-[4]: /integrations/intercom
-[5]: https://docs.datadoghq.com/help/
-[6]: https://developers.intercom.com/docs/references/2.10/webhooks/webhook-models
+[4]: https://docs.datadoghq.com/help/
+[5]: https://developers.intercom.com/docs/references/2.10/webhooks/webhook-models
diff --git a/intercom/assets/webhook_config.json b/intercom/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "intercom"}
diff --git a/jamf_pro/README.md b/jamf_pro/README.md
@@ -8,13 +8,11 @@ Integrate Jamf Pro with Datadog to gain insights into [Events][2] using pre-buil
 
 ## Setup
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward Jamf Pro detections as logs to Datadog.
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Jamf Pro][3] tile.
+1. {{< integration-api-key-picker >}}
 2. In Jamf Pro, click **Settings** in the sidebar.
 3. In the **Global** section, click **Webhooks**.
 4. Click **New**.
@@ -46,9 +44,8 @@ The Jamf Pro integration does not include any events.
 
 ## Support
 
-For any further assistance, contact [Datadog support][4].
+For any further assistance, contact [Datadog support][3].
 
 [1]: https://www.jamf.com/products/jamf-pro/
 [2]: https://developer.jamf.com/jamf-pro/docs/webhooks-1
-[3]: /integrations/jamf-pro
-[4]: https://docs.datadoghq.com/help/
+[3]: https://docs.datadoghq.com/help/
diff --git a/jamf_pro/assets/webhook_config.json b/jamf_pro/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "jamf-pro"}
diff --git a/postmark/README.md b/postmark/README.md
@@ -11,17 +11,15 @@ To gain insights into Postmark's broadcast and transactional message streams, in
 Follow the instructions below to configure this integration for your Postmark account.
 
 
-### Configuration
-
-#### Enable open and link tracking in server settings for the message streams
+### Enable open and link tracking in server settings for the message streams
 Follow these steps to enable both features:
 
 1. Log into your [Postmark account][3]. This redirects you to the [servers][4] page.
 2. Select the desired server. This redirects you to the **Message Streams** page.
 3. In the navigation panel, click the **Settings** tab.
 4. In the **Tracking** section, enable both **Open tracking** and **Link tracking**.
 
-#### Webhook configuration steps
+### Webhook configuration steps
 Configure the Datadog endpoint to forward the following activity logs to Datadog:
 - **Broadcast** message streams
 - **Transactional** message streams
@@ -30,7 +28,7 @@ See [Postmark Webhook Overview][2] for more details.
 
 Perform the following steps to configure the webhook for both of the message streams mentioned above.
 
-1. Select an existing API key or create a new one by clicking one of the buttons below:<!-- UI Component to be added by DataDog team -->
+1. {{< integration-api-key-picker >}}
 2. Log in to your [Postmark account][3]. This redirects you to the [servers][4] page.
 3. Select the desired server. This redirects you to the **Message Streams** page.
 4. On the message streams page, select an existing broadcast or transactional message stream or create a new one. 
diff --git a/postmark/assets/webhook_config.json b/postmark/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "postmark"}
diff --git a/push_security/README.md b/push_security/README.md
@@ -8,13 +8,11 @@ Integrate Push Security with Datadog's pre-built dashboard visualizations to gai
 
 ## Setup
 
-### Configuration
-
-#### Webhook Configuration
+### Webhook Configuration
 
 Configure the Datadog endpoint to forward Push Security events as logs to Datadog:
 
-1. Copy the generated URL inside the **Configuration** tab on the Datadog [Push Security][5] tile.
+1. {{< integration-api-key-picker >}}
 2. Sign in to [Push Security Portal][3].
 3. Go to **Settings** > **Webhooks**.
 4. Click **+ Webhook**.
@@ -49,4 +47,3 @@ For further assistance, contact [Datadog support][4].
 [2]: https://pushsecurity.redoc.ly/webhooks-v1#operation/account-event
 [3]: http://login.pushsecurity.com/u/login
 [4]: https://docs.datadoghq.com/help/
-[5]: /integrations/push-security
diff --git a/push_security/assets/webhook_config.json b/push_security/assets/webhook_config.json
@@ -0,0 +1 @@
+{"type": "url", "source": "pushsecurity"}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{"type": "url", "source": "beyond-trust-identity-security-insights"}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{"type": "url", "source": "checkpoint-harmony-email-and-collaboration"}`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{"type": "url", "source": "contentful"}`