---
title: "Create Client"
method: POST
path: "/clients.json"
tags: ["Clients"]
---

# Create Client

`POST /clients.json`

Creates a new client.

## Query parameters

- `api_key` string, required

## Request body

- ClientRequest
  - `client` object, required
    - `name` string, required
    - `code` string, required
    - `email` string
    - `language` 'en' | 'pt' | 'es'
    - `address` string
    - `city` string
    - `postal_code` string
    - `country` string
    - `fiscal_id` string
    - `website` string
    - `phone` string
    - `fax` string
    - `preferred_contact` object — The preferred contact details.
      - `name` string
      - `email` string
      - `phone` string
    - `observations` string
    - `send_options` '1' | '2' | '3'

## Response `201`

SUCCESS

- ClientsGetResponse
  - `client` object
    - `id` string
    - `name` string
    - `email` string
    - `address` string
    - `city` string
    - `postal_code` string
    - `fiscal_id` string
    - `website` string
    - `country` string
    - `phone` string
    - `fax` string
    - `preferred_contact` object
      - `name` string
      - `email` string
      - `phone` string
    - `observations` string
    - `open_account_link` string
    - `send_options` string
    - `payment_days` string
    - `tax_exemption_code` string

## Other responses

- `401` — ACCESS DENIED
- `422` — UNPROCESSABLE ENTITY

---

[API](https://skmtc.net/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.net/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/versions/5cea7e1d8f41/schema)