---
title: "POST /v1/buyers/{buyersId}/clients/{clientsId}/users"
method: POST
path: "/v1/buyers/{buyersId}/clients/{clientsId}/users"
tags: ["buyers"]
---

# POST /v1/buyers/{buyersId}/clients/{clientsId}/users

`POST /v1/buyers/{buyersId}/clients/{clientsId}/users`

## Request

- Base URL: `https://authorizedbuyersmarketplace.googleapis.com`
- URL: `https://authorizedbuyersmarketplace.googleapis.com/v1/buyers/{buyersId}/clients/{clientsId}/users`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`

Creates a new client user in "INVITED" state. An email invitation will be sent to the new user, once accepted the user will become active.

## Path parameters

- `buyersId` string, required
- `clientsId` string, required

## Request body

- ClientUser: A user of a client who has restricted access to the Marketplace and certain other sections of the Authorized Buyers UI based on the role granted to the associated client.
  - `email` string: Required. The client user's email address that has to be unique across all users for the same client.
  - `name` string: Output only. The resource name of the client user. Format: `buyers/{accountId}/clients/{clientAccountId}/users/{userId}`
  - `state` 'STATE_UNSPECIFIED' | 'INVITED' | 'ACTIVE' | 'INACTIVE': Output only. The state of the client user.

## Response `200`

Successful response

- ClientUser: A user of a client who has restricted access to the Marketplace and certain other sections of the Authorized Buyers UI based on the role granted to the associated client.
  - `email` string: Required. The client user's email address that has to be unique across all users for the same client.
  - `name` string: Output only. The resource name of the client user. Format: `buyers/{accountId}/clients/{clientAccountId}/users/{userId}`
  - `state` 'STATE_UNSPECIFIED' | 'INVITED' | 'ACTIVE' | 'INACTIVE': Output only. The state of the client user.

## Changes

- **2026-10-29** `4e374f878f32`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/changes/v1/buyers/:buyersId/clients/:clientsId/users/post.md)

---

[API](https://skmtc.dev/google/apis/authorizedbuyersmarketplace.md) - [All operations](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/revisions/4e374f878f32?raw)