---
title: "Create client"
method: POST
path: "/partner_api/v1/clients"
tags: ["Clients"]
---

# Create client

`POST /partner_api/v1/clients`

## Request

- Base URL: `https://api.contentsnare.com`
- URL: `https://api.contentsnare.com/partner_api/v1/clients`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorization`
    - Token URL: `/oauth/token` scopes: `write_clients`
  - HTTP bearer

Creates a new client<br>Required scopes: <b>write_clients</b>

## Request body

- NewClient
  - `client_companies` object[]
    - `name` string, required: Company name
  - `email` string, required: Contact email address
  - `full_name` string, required: Contact full name
  - `first_name` string: Contact first name
  - `last_name` string: Contact last name
  - `phone` string: Phone number
  - `salutation` string: Salutation (e.g. Mr, Mrs, Dr)
  - `language_code` 'en' | 'en-gb' | 'es' | 'fr' | 'de' | 'nl' | 'pt-br': Language code

## Response `201`

successful

- Client
  - `avatar` string
  - `client_companies` ClientCompany[]
    - `id` string
    - `name` string
  - `company_name` string
  - `email` string
  - `full_name` string
  - `first_name` string
  - `last_name` string
  - `id` string
  - `phone` string
  - `salutation` string
  - `language_code` string

## Other responses

- `401`: unauthorized
- `403`: forbidden
- `422`: unprocessable entity

---

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