---
title: "Adicionando Contatos"
method: POST
path: "/api/v4/contacts"
---

# Adicionando Contatos

`POST /api/v4/contacts`

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/contacts`
- Auth: OAuth 2

Este método permite adicionar múltiplos ou um único contato na conta.

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string: Nome completo do Contato
    - `first_name` string: Nome do Contato
    - `last_name` string: Sobrenome do Contato
    - `responsible_user_id` integer: ID do Usuário responsável do Contato
    - `created_by` integer: ID do Usuário que criou o Contato
    - `updated_by` integer: ID do Usuário que atualizou o Contato por último
    - `created_at` integer: Data de criação do Contato no formato de Unix Timestamp
    - `updated_at` integer: Data de atualização do Contato no formato de Unix Timestamp
    - `custom_fields_values` string, json: Um array dos valores atuais dos campos personalizados do Contato
    - `_embedded` object
      - `tags` object[]
        - `id` integer: ID da tag
        - `name` string: Nome da tag
    - `tags_to_add` object[]: Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.
      - `id` integer: ID da tag
      - `name` string: Nome da tag
    - `tags_to_delete` object[]: Array de tags a serem deletadas. Você precisa passar o nome ou o ID da tag.
      - `id` integer: ID da tag
      - `name` string: Nome da tag

## Response `200`

200

- object
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `contacts` object[]
      - `id` integer
      - `is_deleted` boolean
      - `is_unsorted` boolean
      - `request_id` string
      - `_links` object
        - `self` object
          - `href` string

## Other responses

- `400`: 400
- `401`: 401

---

[API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)