---
title: "POST /v1/{+parent}/clients"
method: POST
path: "/v1/{+parent}/clients"
tags: ["buyers"]
---

# POST /v1/{+parent}/clients

`POST /v1/{+parent}/clients`

Creates a new client.

## Path parameters

- `parent` string, required

## Request body

- Client — A client represents an agency, a brand, or an advertiser customer of the buyer. Based on the client's role, its client users will have varying levels of restricted access to the Marketplace and certain other sections of the Authorized Buyers UI.
  - `name` string — Output only. The resource name of the client. Format: `buyers/{accountId}/clients/{clientAccountId}`
  - `displayName` string — Required. Display name shown to publishers. Must be unique for clients without partnerClientId specified. Maximum length of 255 characters is allowed.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'INACTIVE' — Output only. The state of the client.
  - `sellerVisible` boolean — Whether the client will be visible to sellers.
  - `role` 'CLIENT_ROLE_UNSPECIFIED' | 'CLIENT_DEAL_VIEWER' | 'CLIENT_DEAL_NEGOTIATOR' | 'CLIENT_DEAL_APPROVER' — Required. The role assigned to the client. Each role implies a set of permissions granted to the client.
  - `partnerClientId` string — Arbitrary unique identifier provided by the buyer. This field can be used to associate a client with an identifier in the namespace of the buyer, lookup clients by that identifier and verify whether an Authorized Buyers account of the client already exists. If present, must be unique across all the clients.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/authorizedbuyersmarketplace.md) · [All operations](https://skmtc.net/google/apis/authorizedbuyersmarketplace/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/authorizedbuyersmarketplace/revisions/13e307206f76/schema)