---
title: "POST /entities"
method: POST
path: "/entities"
---

# POST /entities

`POST /entities`

## Headers

- `x-api-key` string, required
- `x-account-key` string

## Request body

- object
  - `customer` object, required
    - `external_id` string, required — Identificador externo del cliente (máx. 128 caracteres).
    - `government_id` string — Requerido según organización. RUT u otro ID tributario (ej. Chile: formato válido con dígito verificador). Requerido si la organización lo exige.
    - `name` string — Nombre (máx. 128).
    - `phone_number` string — Teléfono (máx. 16).
    - `metadata` object — Metadatos (clave/valor).
  - `subscription` object, required
    - `product_id` string, required — Identificador del producto (mín. 1 carácter).
    - `is_recurring` string — Si la suscripción es recurrente.
    - `currency_code` string — Código de moneda (ej. CLP, USD).
    - `frequency` string — Frecuencia de cobro.
    - `interval` string — Intervalo.
    - `due_day` string — Día de vencimiento (1–31).
    - `amount` string — Monto (≥ 0).
    - `receipt_product_code` string — Código de producto en boleta (máx. 8).
    - `metadata` object — Metadatos (clave/valor).
  - `invoice` object
    - `amount` number, required — Monto (≥ 0).
    - `due_date` string, required — Fecha de vencimiento en formato YYYY-MM-DD.
    - `currency_code` string — Código de moneda.
    - `product_id` string — ID del producto.
    - `link_payment` string — URL de pago (formato URL válido).
    - `metadata` object — Metadatos (clave/valor).
    - `invoice_external_id` string — ID externo de la factura (máx. 256).
    - `receipt_type` string — Tipo de documento (ej. invoice, bill).
    - `is_paid` boolean — Si está pagada.
    - `is_void` boolean — Si está anulada (default: false).

## Response `200`

OK

## Other responses

- `201` — Created
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

---

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