CRM v1 vigente
crm.
Abre un negocio nuevo en el pipeline para un cliente dicho por su nombre, con título, valor opcional en USD, etapa opcional (por nombre; sin ella, la primera) y responsable opcional. No comprueba si ya tiene otros abiertos: devuelve cuántos quedan para que se vea un duplicado. No lo gana ni lo pierde: eso es crm.stage_moved.
Última actualización
POST /api/v1/actions/crm.deal_created- Alcance de la llave
crm.deal_created@1- Permiso del workspace
api.crm.deal_createdapagado por defecto
Hacen falta las dos cosas: una llave con ese alcance, y que el dueño del workspace haya encendido el permiso. Tener la llave no basta — son dos decisiones de personas distintas.
Petición
| campo | tipo | reglas | |
|---|---|---|---|
client | string | obligatorio | min 1 · max 200 |
title | string | obligatorio | min 1 · max 200 |
valueUsd | string | opcional | ^\d+(\.\d{1,2})?$ |
stage | string | opcional | min 1 · max 120 |
owner | string | opcional | min 1 · max 200 |
Respuesta — output cuando status es done
| campo | tipo | reglas | |
|---|---|---|---|
dealId | string | obligatorio | |
clientId | string | obligatorio | |
clientName | string | obligatorio | |
title | string | obligatorio | |
valueUsd | string | null | obligatorio | |
stageName | string | obligatorio | |
ownerName | string | null | obligatorio | |
openDeals | integer | obligatorio | ≥ 1 |
Ejemplo
# One request, one idempotency key: retrying with the same key never runs twice.
curl -X POST https://niiko.org/api/v1/actions/crm.deal_created \
-H "Authorization: Bearer nk_…" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"client": "…",
"title": "…"
}'
# 200 → done · 202 → pending_approval (a person signs later) · 4xx → refused, with a named reasonPor qué puede negarse
Cada motivo dice quién puede arreglarlo y cómo. Con motivo stale, detail.message dice qué hacer.
cliente_no_encontradocliente_ambiguodemasiados_clientesetapa_no_encontradaetapa_cerradapersona_no_encontradapersona_ambiguasin_permiso
En los clientes
| @vorluno/niiko-sdk | niiko.createdDeal() |
| niiko (Python) | niiko.created_deal() |
| niiko-cli | niiko run crm.deal_created |
| n8n-nodes-niiko | crmDealCreated |
| niiko-mcp-server | crm_deal_created |