---
title: "Crear Customer desde PlanOk"
method: POST
path: "/planok/customer"
tags: ["PlanOk"]
---

# Crear Customer desde PlanOk

`POST /planok/customer`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/planok/customer`
- Auth: API key in header `x-api-key`

Crea en Toku el `Customer` y la deuda asociados a una promesa de pago de PlanOk.

Lo invoca PlanOk cuando registra una nueva promesa de pago: con los datos del cliente y de la promesa se crea o actualiza el `Customer` y se generan los `Invoices` que corresponden a las cuotas comprometidas.

La cuenta sobre la que se opera se resuelve desde las credenciales de la solicitud.

## Headers

- `x-account-key` string

## Request body

- PlanOkCustomerRequest
  - `cliente` object, required: Cliente
  - `id_promesa` string, required: Promise ID

## Response `200`

Successful Response

- IntegrationEtlMessageResponse: Confirmación simple de una operación procesada.
  - `message` string, required: Detalle textual del resultado de la operación.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/planok/customer/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)