Skip to main content
POST
/
api
/
v1
/
audience-syncs
Create Audience Sync
curl --request POST \
  --url https://api.sequenzy.com/api/v1/audience-syncs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "segmentId": "<string>",
  "predefinedSegmentId": "<string>",
  "adAccountId": "<string>",
  "audienceName": "<string>",
  "frequency": "<string>"
}
'
{
  "success": true,
  "audienceSync": {
    "id": "sync_abc123",
    "segmentId": "seg_recent_buyers",
    "segmentName": "Recent buyers",
    "adAccountId": "act_1234567890",
    "audienceName": "Sequenzy - Recent buyers",
    "frequency": "daily",
    "isActive": true,
    "syncStatus": "idle",
    "lastSyncAt": null,
    "lastSyncError": null,
    "lastSyncedCount": 0,
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}
Create an audience sync. The custom audience is created in your Meta ad account, the first upload runs immediately, and afterwards the audience refreshes on the chosen schedule. Requires the Meta Ads integration to be connected in the dashboard (Settings → Integrations).

​
Request

​
segmentId
string
Existing segment ID to sync. Provide either segmentId or predefinedSegmentId, not both.
​
predefinedSegmentId
string
Ready-made segment template ID, for example zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, or engaged. The segment is created automatically on first use and reused afterwards. If an unrelated segment with the template’s name but different filters already exists, the request fails with a 409 - sync that segment via segmentId or rename it.
​
adAccountId
string
required
Meta ad account ID (act_...). Use List Ad Accounts to find it.
​
audienceName
string
required
Name for the custom audience in Meta Ads Manager.
​
frequency
string
default:"daily"
How often the segment is re-uploaded: hourly, daily, or weekly.
curl -X POST "https://api.sequenzy.com/api/v1/audience-syncs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "predefinedSegmentId": "recent-buyers",
    "adAccountId": "act_1234567890",
    "audienceName": "Sequenzy - Recent buyers",
    "frequency": "daily"
  }'
Audiences are add-only: subscribers who later leave the segment stay in the Meta audience. Meta requires 100+ matched people before an audience can be used for ad delivery.

​
Responses

{
  "success": true,
  "audienceSync": {
    "id": "sync_abc123",
    "segmentId": "seg_recent_buyers",
    "segmentName": "Recent buyers",
    "adAccountId": "act_1234567890",
    "audienceName": "Sequenzy - Recent buyers",
    "frequency": "daily",
    "isActive": true,
    "syncStatus": "idle",
    "lastSyncAt": null,
    "lastSyncError": null,
    "lastSyncedCount": 0,
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}