List account users

customer_get_users (MCP tool) Returns every user with active access to an account. If the authenticated user is an admin on a parent organization, the response covers the parent and all child accounts — each user appears once, with a customerMemberships array listing every account they can access. Users whose access comes from parent-organization admin propagation appear alongside directly-invited members.

Parameters

Field	Type	Required	Notes
`customerId`	integer	No	Account to query. Defaults to your current account context. Parent admins can pass any child account ID.

Response

{
  "users": [
    {
      "id": "42",
      "email": "alice@example.com",
      "firstName": "Alice",
      "lastName": "Smith",
      "customerMemberships": [
        {
          "customerId": 100,
          "customerName": "Acme Inc",
          "role": "ADMIN"
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "customers": [
    { "id": 100, "name": "Acme Inc" }
  ]
}

Field	Type	Notes
`users`	array	Users with active access
`users[].id`	string	User ID
`users[].email`	string	Email address
`users[].firstName`	string	First name
`users[].lastName`	string	Last name
`users[].customerMemberships`	array	Accounts this user can access
`users[].customerMemberships[].customerId`	integer	Account ID
`users[].customerMemberships[].customerName`	string	Account display name
`users[].customerMemberships[].role`	string	Permission level: `BASIC`, `PREMIUM`, `ADMIN`, or `SUPER_ADMIN`
`users[].createdAt`	string	ISO 8601 timestamp
`count`	integer	Total number of unique users
`customers`	array	Accounts covered by this response, for filter dropdowns

Errors

401 UNAUTHORIZED — missing or invalid bearer token.
403 FORBIDDEN — caller does not have access to the requested account.
404 NOT_FOUND — account does not exist.

See Errors for the full error contract.

Account tasks

All account operations

Get current account

Your current context

Get membership settings

Domain auto-join settings

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Parameters

Response

Errors

Account tasks

Get current account

Get membership settings

​Parameters

​Response

​Errors

​Related

Account tasks

Get current account

Get membership settings

Parameters

Response

Errors

Related