---
title: "Sync a HighLevel tag to ad audiences"
method: POST
path: "/v1/accounts/{accountId}/gohighlevel-audiences"
tags: ["Accounts"]
---

# Sync a HighLevel tag to ad audiences

`POST /v1/accounts/{accountId}/gohighlevel-audiences`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}/gohighlevel-audiences`
- Auth: HTTP bearer

Keep every HighLevel contact with a tag as a customer list audience on one or more Meta or Reddit ad accounts of the profile. Take `targets` from `targetChoices` of `listGohighlevelAudienceSyncs`.

Zernio creates one audience per ad account and fills it within a few minutes. A contact joins or leaves as soon as the tag is added to or removed from it, and every 6 hours Zernio re-reads the tag. Emails and phones are hashed before upload.

A tag syncs once per sub-account; stop it to change its ad accounts. Needs a read-write key.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `tag` string, required: The HighLevel tag, matched case-insensitively.
  - `targets` object[], required: The ad accounts to keep the audience on, each one of `targetChoices`.
    - `accountId` string, required: The Zernio ads connection id (`targetChoices[].accountId`).
    - `adAccountId` string, required: The ad account on that connection, such as `act_123456789` for Meta.
  - `audienceName` string: The audience name on the ad accounts. Default `CRM tag: <tag>`.

## Response `201`

Sync started

- object
  - `sync` GohighlevelAudienceSync
    - `id` string, required
    - `tag` string, required: The HighLevel tag, lowercased.
    - `status` 'syncing' | 'ready' | 'error', required
    - `memberCount` integer, required: Contacts with the tag uploaded to the audiences so far.
    - `lastError` string, nullable, required
    - `audiences` object[], required
      - `name` string
      - `platform` string
      - `adAccountId` string, nullable
      - `error` string, nullable: Why the last upload to this audience failed, null when it went through.
  - `failedTargets` string[]: The ad accounts that refused an audience, as `<connection label> · <adAccountId>`. The sync runs on the others.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: The API key is read-only
- `404`: Account not found
- `409`: The tag is being set up or synced right now, or is already synced. Retry later, or stop the existing sync first.

## Changes

- **2026-11-22** `3596659309f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/gohighlevel-audiences/post.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/d7fe40ebafb6?raw)
