---
title: "Actualizar contactos"
method: PATCH
path: "/api/v4/contacts"
---

# Actualizar contactos

`PATCH /api/v4/contacts`

Este método permite actualizar múltiples contactos. Al actualizar varios contactos, se pasa un arreglo de objetos contacto.

## Headers

- `Content-Type` string

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer — ID del contacto
    - `name` string — Nombre completo del contacto
    - `first_name` string — Nombre del contacto
    - `last_name` string — Apellido del contacto
    - `responsible_user_id` integer — ID del contacto responsable
    - `created_by` integer — ID del usuario que creó el contacto
    - `updated_by` integer — ID del usuario que actualizó el contacto por última vez
    - `created_at` integer — Fecha de creación del contacto en formato de Unix Timestamp
    - `updated_at` integer — Fecha de actualización del contacto en formato de Unix Timestamp
    - `custom_fields_values` string, json — Un arreglo de los valores actuales de los campos personalizados del contacto
    - `_embedded` object
      - `tags` object[]
        - `id` integer — ID de la etiqueta.
        - `name` string — Nombre de la etiqueta.
    - `request_id` string — El campo será retornado sin cambios en la respuesta y no se guardará.
    - `tags_to_add` object[] — Arreglo de etiquetas para añadir Debes pasar ya sea el nombre o el ID de la etiqueta.
      - `id` integer — ID de la etiqueta.
      - `name` string — Nombre de la etiqueta.
    - `tags_to_delete` object[] — Arreglo de etiquetas para eliminar. Debes pasar ya sea el nombre o el ID de la etiqueta.
      - `id` integer — ID de la etiqueta.
      - `name` string — Nombre de la etiqueta.

## Response `200`

200

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

## Other responses

- `400` — 400
- `401` — 401

---

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