---
title: "Sync rolling segments with external systems"
slug: "sync-rolling-segments-with-external-systems"
updated: 2026-10-19T12:16:32Z
published: 2026-10-19T12:16:32Z
canonical: "docs.xtremepush.com/sync-rolling-segments-with-external-systems"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync rolling segments with external systems

> [!NOTE]
> Can’t see this option?
> 
> This feature is not enabled on projects by default. To enable it, contact your Account Manager.

You can automate the sync of your rolling segment data with your external system by configuring a rolling segment **Destination**. Every time a rolling segment updates on its hourly schedule, a list of users who have been added or removed is sent to your system using a webhook.

The data payload for this event will always include each user's `user_id`. If the `customer_id` is enabled on the project, then `customer_id` will also be included in the payload. User IDs in the payload are grouped by `add` or `remove` actions.

## Prerequisites

To use this feature, you must first configure a **Webhook Stream** integration. This contains the destination URL and authentication details for your external system. For configuration details, see [Webhook Streams](/documentation/docs/webhook-stream).

## Configure external sync of Rolling Segments

To activate the external sync of your rolling segment, you must configure a destination in your rolling segment configuration:

1. Go to **Data** > **Audiences** > **Rolling Segments**
2. Select your rolling segment or create a new one.
3. Click **Add Destinations** and provide the following details:
  1. **Webhook Stream Integration**: From the drop-down, select the Webhook Stream associated with your destination URL.
  2. **External Segment ID**: Select the segment in your external system that maps to this rolling segment.

> [!NOTE]
> Selecting the external segment ID
> 
> To select an external segment from the drop-down, you must configure the **Segment Source Settings** in your **Webhook Stream** integration. For more information on the configuration, see [Webhook Stream](/documentation/docs/webhook-stream).
> 
> 
> 
> If the segment source is not enabled, you must type the external segment ID manually.
4. Save your changes.

Once saved, the sync becomes active. Updates are sent to your configured destination starting with the next hourly cycle.

> [!WARNING]
> Rolling Segment Calculation Time Limit
> 
> A segment calculation times out if it runs longer than five minutes. When this happens, the sync for that specific hourly cycle fails and an error message is generated. The segment stops syncing and must be manually re-enabled by clicking **Enable Sync**.