---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Configure a Datadog work item connector instance

# Configure a Datadog work item connector instance {#ariaid-title1}

Release version: Brazil  
Updated September 30, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Configure a Datadog work item to aggregate related alerts and signals from Datadog into a trackable operational problem.

## Before you begin

* Verify you already have a Datadog account with API access and Case Management in use.
* Role required: evt_mgmt_operator

## About this task

ServiceNow represents a work item as an alert. Each related alert is retained individually, enabling grouping and correlation across multiple resources and monitoring systems. Alerts aren't limited
to those Datadog grouped. As a result, ServiceNow identifies broader incidents, reduces duplicate alerts, and provides a more comprehensive operational view.  
Note the following before you start:

* If you already use the Datadog push connector, use the same push connector URL to send work items. Configure the Datadog Case Management notification rule and the case payload template described on the push connector page.
* The push connector receives the work item and creates the work item alert and its tracking records. The pull connector then fetches the correct work item title, retrieves related alerts, and drives bi-directional close-back.
{#configure-a-datadog-work-item-connector__ul_i42_nw2_tkc}

## Procedure

1. Navigate to AllEvent ManagementIntegrationsPush Connectors.  
   Note:  
   Create this push connector to auto-create the pull connector with the matching name. The connector names must match for bi-directional and fetch related alerts.
2. Select a Datadog Push Connector instance used to send work items.
3. Select the Configure Work Item Alerts button.  
   You're redirected to the pull connector instance form.
4. Fill in the fields.

   | Field | Description |
   | Name | Name of the connector. The pull connector instance name must match the push connector instance name. |
   | Description | Any optional information that you want to use to identify this record. |
   | Host IP | Use your Datadog site's API host. For example, `api.datadoghq.eu` |
   | Credential | The ServiceNow credential record that stores your Datadog API key or access token. The authentication method is controlled by the `useAccessToken` connector instance value. For more information, see the Connector instance value parameters table. |
   | Active | This option appears only after the form is saved. |
   | Bi-directional | Select to enable bi-directional exchange of values to and from the external event source. This option is available only when the connector definition has bi-directional values configured. After a work item alert is closed in ServiceNow, the corresponding case is automatically closed in Datadog. |
   | Last bi-directional status | The value of this field is automatically populated. This option appears only when the Bi-directional option is selected.The status values are: * None - A valid connection has not yet been established. * Success - A successful connection was established. * Error - A connection was established. However the external event source was not updated. {#configure-a-datadog-work-item-connector__t_EMConfigureConnectorInstance_ul_igw_dxh_kv} |
   |-|-|

   Connector instance value parameters:

   | Parameter | Description |
   | useAccessToken | Controls the authentication method. By default, this value is false. The Credential option must store the Datadog API key and you must set application_key. The connector sends the `DD-API-KEY` and `DD-APPLICATION-KEY` headers. When this value is true, the Credential option must store the Datadog OAuth access token. The connector sends `Authorization: Bearer <token> header (application_key is not used)`. |
   | application_key | The application key of the Datadog connector. By default, this value is empty which indicates Basic authentication. |
   | fetchCaseRelatedAlerts | Controls whether related alerts are fetched for the work item. The default is true. Set it to false to disable. |
   | caseApiPath | Set as `/api/v2/cases/`. |
   | eventApiPath | Set as `/api/v2/events/`. |
   |-|-|

   {#configure-a-datadog-work-item-connector__choicetable_uxg_y1j_tkc}
5. Right-select the form header and select Save.
6. Select Test connector to verify the connection.
7. After a successful test, select the Active check box and then select Update.
**Related concepts**   

* [Configure a push connector](https://www.servicenow.com/docs/GVk94e2aPcyE4gbgmbrndQ "You can configure listeners and connectors to push event information to the instance or MID Server.")

*[\>]: and then