# Source: https://docs.datadoghq.com/incident_response/on-call/cross_org_paging.md

---
title: Cross-org Paging
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Incident Response > On-Call > Cross-org Paging
---

# Cross-org Paging

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site). ().
{% /alert %}

{% /callout %}

{% alert level="info" %}
Cross-org paging is in Public Preview and is supported only for automated workflows, such as monitor alerts and incident notification rules. Manual paging through the Datadog UI or API is limited to the local organization and data center.
{% /alert %}

## Overview{% #overview %}

Cross-org paging enables users to automatically trigger alerts to On-Call teams that reside in other Datadog organizations or data centers. Cross-org paging is useful when your operational or organizational setup spans multiple Datadog orgs or data centers, and you want to centralize incident response in one single org.

With cross-org paging, you can:

- **Manage On-Call teams in a central org**: Consolidate all On-Call teams in a single org, and trigger pages from any org or region.

- **Avoid duplicating On-Call configs**: Instead of replicating the same team structures across orgs, use one set of configs and page teams from anywhere.

- **Page teams across regional or compliance boundaries**: Page teams in compliant regions (like US1 or AP1) while keeping alerting logic where it originates.

## Setup{% #setup %}

To enable paging between orgs or datacenters, you must establish a secure connection between the **source org** (where alerts originate) and the **destination org** (where the On-Call team is managed).

1. In your destination org, [create a service account](https://app.datadoghq.com/organization-settings/service-accounts) with On-Call API access. Assign the service account to a role that includes the following permissions:

   - `on_call_read` - Read access to On-Call teams and configurations
   - `on_call_page` - Ability to trigger pages to On-Call teams
   - `on_call_respond` - Respond to On-Call Pages
   - `user_access_read` - Read user information (automatically included in most roles)
Important alert (level: danger): Service accounts created with Terraform may be missing the `user_access_read` permission. This permission is automatically added to roles created through the UI, but it cannot be manually added through the UI and may not be included in Terraform-configured roles. If cross-org paging fails with permission errors, add an additional role to your service account that includes the `user_access_read` permission.
1. In your destination org, [create an API key](https://app.datadoghq.com/organization-settings/api-keys).

1. In your destination org, [create an application key](https://app.datadoghq.com/personal-settings/application-keys) for each source org you want to allow. Ensure that each application key is **unscoped** (not restricted to specific scopes).

1. In your source org, navigate to your [On-Call settings](https://app.datadoghq.com/on-call/settings) and select [**Cross-Org Paging**](https://app.datadoghq.com/on-call/settings/cross-org-paging).

1. Select **Add Connection** and provide the following values:

   - **Connection Name**: A name for your new connection.
   - **Datacenter**: Your destination org's data center.
   - **API Key**: The API key you created in your destination org.
   - **Application Key**: The application key you created in your destination org for this source org.

When you create this connection, Datadog securely stores your credentials and fetches available On-Call team handles from the destination org. This process may take up to five minutes.

After this process is complete, destination org team handles appear in your source org's autocomplete menus (for example, in monitors).

### Usage{% #usage %}

After the setup process is complete, you can reference cross-org On-Call team handles in automated alert workflows, in the same way that you reference local handles.

For example, if your `@oncall-core-infra` team is managed in your destination org, you can use the following in an automated alert in your source org:

```
High memory usage detected on backend services. @oncall-core-infra
```

When an alert is triggered, Datadog detects that the handle is external, and the page is routed to the correct destination org using the stored service account credentials.

## Limitations{% #limitations %}

- Manual paging (for example, through the API or web UI) is not supported across orgs. Manual paging is only supported within your current org or data center.
- Links in cross-org notifications (for example, monitor or incident URLs) point to the source org. They may not resolve cleanly in the destination org UI.
- Handle syncing happens periodically; changes in destination org On-Call teams may take time to propagate.

## Further Reading{% #further-reading %}

- [Datadog On-Call](https://docs.datadoghq.com/incident_response/on-call/)