---
title: "Adicionar pessoa"
method: POST
path: "/persons"
---

# Adicionar pessoa

`POST /persons`

## Request body

- object
  - `name` string, required — Nome do contato.
  - `city_id` integer — ID da cidade.
  - `address_postal_code` string — CEP do endereço da pessoa.
  - `address_complement` string — Complemento de endereço da pessoa.
  - `address_number` string — Número do endereço da pessoa.
  - `address` string — Logradouro da pessoa.
  - `district` string — Bairro da pessoa.
  - `avatar` string — URL apontando para uma imagem de avatar.
  - `birth_day` string, date — Data de nascimento da pessoa.
  - `company_id` integer — ID da empresa atrelada a pessoa.
  - `manager_id` integer — ID do CS Responsável da pessoa.
  - `cpf` string — CPF da pessoa. Formatos aceitos: 123.456.789-01, 12345678901.
  - `customer_at` string, date — Data em que a pessoa se tornou cliente.
  - `gender` string — Gênero dessa pessoa ("Masculino" ou "Feminino").
  - `job_title` string — Título do cargo da pessoa.
  - `observation` string — Observações sobre a pessoa.
  - `website` string — URL apontando para o website da pessoa.
  - `facebook` string — URL apontando para o perfil do Facebook da pessoa.
  - `linkedin` string — URL apontando para o perfil do LinkedIn da pessoa.
  - `tags` object[] — Array contendo os IDs das tags
    - `id` integer — ID da Tag.
  - `contactEmails` string[] — Array referenciando emails da pessoa.
  - `contactPhones` string[] — Array referenciando telefones da pessoa.
  - `custom_fields` object[] — Array contendo o ID e os valores dos campos customizados.
    - `id` integer — ID do campo customizado.
    - `value` string — Valor do campo customizado.

## Response `201`

201

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` integer
    - `account_id` integer
    - `city_id` integer
    - `owner_id` integer
    - `manager_id` integer
    - `cpf` string
    - `avatar` string
    - `name` string
    - `hash` string
    - `website` string
    - `job_title` string
    - `gender` string
    - `birth_day` string
    - `observation` string
    - `customer_at` string
    - `facebook` string
    - `linkedin` string
    - `address_postal_code` string
    - `address` string
    - `address_number` string
    - `address_complement` string
    - `district` string
    - `created_at` string
    - `lat` string
    - `lng` string
    - `external_code` string
    - `status` integer
    - `foreign_contact` integer
    - `city` object
      - `id` integer
      - `uf` string
      - `name` string
    - `contact_emails` object
      - `id` integer
      - `account_id` integer
      - `company_id` integer
      - `person_id` integer
      - `type` string
      - `email` string
      - `is_main` integer
    - `contact_phones` object
      - `id` integer
      - `account_id` integer
      - `company_id` integer
      - `person_id` integer
      - `type` string
      - `phone` string
      - `is_main` integer
    - `custom_fields` object

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/pipe/apis/application-json.md) · [All operations](https://skmtc.net/pipe/apis/application-json/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipe/application-json/revisions/0a130198f0a3/schema)