---
title: "contacts__createContact"
method: POST
path: "/tools/contacts__createContact"
tags: ["Contacts"]
---

# contacts__createContact

`POST /tools/contacts__createContact`

Crea un contacto (cliente, proveedor, o ambos). Equivale a `POST /contacts`. Únicamente `name` es obligatorio para Alegra; los demás campos son opcionales y dependen del país y del flujo del usuario (facturación electrónica, contabilidad, retenciones, etc.). Para facturar en países con DIAN/SUNAT/SAT, normalmente también se requiere `identification` y `type`.

## Request body

- object
  - `contact` object, required
    - `name` string, required — Nombre o razón social del contacto.
    - `identification` string — Número de identificación (NIT, cédula, RFC, RUT, etc.).
    - `type` string[] — Tipos del contacto. Combinable, p. ej. `["client", "provider"]`.
    - `status` 'active' | 'inactive' — Estado del contacto.
    - `email` string, email
    - `phonePrimary` string — Teléfono principal.
    - `phoneSecondary` string
    - `mobile` string
    - `fax` string
    - `address` object — Dirección física principal.
      - `city` string
      - `address` string
    - `seller` string — ID del vendedor asignado al contacto.
    - `priceList` string — ID de la lista de precios asignada.
    - `term` string — ID del término de pago (días o configuración).
    - `creditLimit` number — Cupo de crédito otorgado al contacto.
    - `accounting` object — Configuración contable (cuentas asociadas).
      - `debtToPay` string — ID/código de la cuenta contable de cuentas por pagar.
      - `accountReceivable` string — ID/código de la cuenta contable de cuentas por cobrar.
    - `internalContacts` object[] — Personas dentro de la organización contacto (puntos de contacto).
      - `name` string
      - `lastName` string
      - `email` string, email
      - `mobile` string
      - `phone` string
      - `sendNotifications` 'yes' | 'no' — Si recibe notificaciones por email (campo soportado por la API; no validado en el schema MCP actual).
    - `ignoreRepeated` boolean — Si es `true`, no falla cuando ya existe un contacto con la misma identificación.
    - `statementAttached` 'yes' | 'no' — Si se adjunta el estado de cuenta en envíos por email.

## Response `200`

Contacto creado exitosamente.

## Other responses

- `401` — No autorizado.

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)