Crear contact

​

Permite crear contact.

Headers

  • x-org-id
    Type: string
    required

    UUID de la organización

  • x-api-key
    Type: string

    API Key de la organización (zk_...)

  • x-api-secret
    Type: string

    API Secret de la organización (sk_...)

Body·

required
application/json
  • type
    Type: "INTERNAL" or "INTERBANK" or "INTERNATIONAL"enum
    required

    INTERNAL = usuario de la misma org, INTERBANK = contacto externo

  • account_number
    Type: string

    Número de cuenta para contactos internacionales

  • account_type
    Type: string

    Tipo de cuenta (ej. AHORROS, CORRIENTE)

  • alias
    Type: string

    Alias para el contacto

  • cedula
    Type: string

    Cédula o documento de identidad

  • country
    Type: string

    País (ISO-2) para contactos internacionales

  • email
    Type: string

    Correo electrónico

  • full_name
    Type: string

    Nombre completo del beneficiario

  • institution
    Type: string

    Institución financiera

  • swift
    Type: string

    Código SWIFT para contactos internacionales

  • user_id
    Type: string

    ID del usuario (misma organización)

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v2/connect/zchat
curl /api/v2/connect/zchat \
  --request POST \
  --header 'x-org-id: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'x-org-id: YOUR_SECRET_TOKEN' \
  --data '{
  "type": "INTERNAL",
  "user_id": "",
  "alias": "",
  "full_name": "",
  "cedula": "",
  "email": "",
  "account_type": "",
  "institution": "",
  "country": "",
  "account_number": "",
  "swift": ""
}'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "owner_user_id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "INTERNAL",
  "alias": null,
  "user_id": null,
  "full_name": null,
  "cedula": null,
  "email": null,
  "account_type": null,
  "institution": null,
  "country": null,
  "account_number": null,
  "swift": null,
  "created_at": "2026-10-07T19:49:14.816Z",
  "updated_at": "2026-10-07T19:49:14.816Z"
}

Recurso creado correctamente.