---
title: "Ad account users"
method: GET
path: "/v1/ads/accounts/users"
tags: ["Ad Accounts"]
---

# Ad account users

`GET /v1/ads/accounts/users`

People of a business portfolio assigned to a Meta ad account, with their tasks.
Ids are business-scoped user ids (see `GET /v1/ads/businesses/users`).

## Query parameters

- `accountId` string, required
- `adAccountId` string, required
- `businessId` string, required

## Response `200`

Assigned users

- object
  - `adAccountId` string
  - `businessId` string
  - `users` MetaAssignedUser[]
    - `id` string — Business-scoped user id.
    - `name` string
    - `tasks` string[]

## Other responses

- `400` — Invalid input, or Meta rejected the query
- `401` — Unauthorized
- `403` — Meta refused: the token lacks business_management or business admin access.
- `404` — The account or requested resource was not found or is not accessible. An account ID may have been disconnected and removed. Read GET /v1/accounts for current account IDs.
- `409` — The account exists but is inactive or needs reconnection. Reconnect it, then read GET /v1/accounts for its current account ID before retrying. Code: ads_connection_required.
- `429` — The connected account's upstream platform quota is exhausted. Reddit rate-limits per connected Reddit user (1000 requests per 10-minute window), and that budget is shared by every operation using that account. Retry after the window resets rather than retrying immediately; repeated calls while exhausted do not succeed and keep the budget spent. Google Ads: writes and reports run on one developer token shared by every Google Ads account on Zernio. The token holds Standard access (no daily operations cap), so this only happens when Google throttles the token or your ad account. The envelope has `code: rate_limited`, `platform: google`, `details.quotaScope: DEVELOPER` (`ACCOUNT` when it is your own ad account's quota), `details.resetsAt` (ISO instant when Google accepts requests again) and `Retry-After` counting down to it. Retrying earlier cannot succeed.
- `501` — Only supported on Meta (facebook/instagram)

## Changes

- **2026-09-29** `698a0d89ab62` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/accounts/users/get.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/69bbe3da3a18?raw)