---
title: "Criar Clientes"
method: POST
path: "/api/customers"
tags: ["Empresa", "Clientes, Moradas e Email", "Clientes"]
---

# Criar Clientes

`POST /api/customers`

Criar Clientes

## Request body

- object
  - `data` object
    - `attributes` object
      - `business_name` string
      - `contact_name` string
      - `email` string
      - `internal_observations` string
      - `mobile_number` number
      - `observations` string
      - `phone_number` number
      - `tax_registration_number` string
      - `website` string
    - `type` string

## Response `200`

Sucesso

- object
  - `data` object
    - `attributes` object
      - `business_name` string
      - `cashed_vat` boolean
      - `contact_name` string
      - `country_iso_alpha_2` string
      - `data` object
      - `email` string
      - `internal_observations` string
      - `is_tax_exempt` boolean
      - `mobile_number` string
      - `not_final_customer` boolean
      - `observations` string
      - `phone_number` string
      - `saft_import_id` unknown
      - `tax_country_region` string
      - `tax_registration_number` string
      - `website` string
    - `id` string
    - `relationships` object
      - `addresses` object
        - `data` unknown[]
          - unknown
      - `company` object
        - `data` object
          - `id` string
          - `type` string
      - `defaults` object
        - `data` unknown
      - `email_addresses` object
        - `data` unknown[]
          - unknown
      - `main_address` object
        - `data` unknown
      - `main_email_address` object
        - `data` unknown
      - `tax_exemption_reason` object
        - `data` unknown
    - `type` string

## Other responses

- `400` — NIF Inválido
- `403` — Recurso já existe

---

[API](https://skmtc.net/toconline/apis/toconline-open-api.md) · [All operations](https://skmtc.net/toconline/apis/toconline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/toconline/toconline-open-api/revisions/2c51a28d0f48/schema)