Trama — Documentación

Una API REST sobre los datos de tu organización: qué alcanza, qué no alcanza a propósito, y dónde sacar una key.

La API REST de Trama te da los datos de tu propia operación —oportunidades, clientes, conversaciones, cotizaciones, catálogo y equipo— desde afuera del panel. Son los mismos datos que ve tu equipo, con el mismo límite de organización.

Está disponible en todos los planes y sin costo extra, el gratuito incluido.

Sacar una key

Dos minutos, desde Desarrolladores en el panel.

Probarla en vivo

Cada página de endpoint tiene un playground: mandás el request desde acá, con tu propia key.

Lo básico


URL base	`https://api.trama.so`
Versión	Todo cuelga de `/v1`
Formato	JSON de ida y de vuelta. `Content-Type: application/json` en cualquier request con body
Autenticación	Una API key de organización, como bearer token — ver Autenticación
Spec	`api.trama.so/v1/openapi.json`, OpenAPI 3.1, generada desde el código que sirve el tráfico

curl https://api.trama.so/v1/opportunities \
  -H "Authorization: Bearer $TRAMA_API_KEY"

Qué se puede hacer hoy

Leer: oportunidades, clientes, conversaciones y sus transcripciones, cotizaciones y sus adjuntos, productos del catálogo, integrantes del equipo.

Escribir: clientes (crear, editar, archivar) y productos del catálogo (crear, editar, archivar).

El resto es sólo lectura a propósito. Los caminos que crean una oportunidad o mueven una tarjeta son los que escriben el agente y las automatizaciones, y un segundo escritor sin noción del ciclo de calificación deja el tablero desalineado de la conversación. Si necesitás escribir ahí, la puerta es el servidor MCP, que pasa por el Trama Agent y respeta las mismas reglas que el panel.

Lo que todavía no está

Conviene saberlo antes de diseñar tu integración alrededor:

No hay webhooks. Nadie te llama: consultás vos. El updatedAt de cada recurso y el Retry-After de un 429 son lo que hace posible consultar con educación.
No podés mandar un mensaje. Ni por WhatsApp ni por ningún canal. Contestarle a un cliente pasa por Trama.
No hay paginación por cursor. Es limit / offset con un total — ver Paginación.

Convenciones

Las fechas con hora son ISO 8601 en UTC (2026-08-29T14:03:11.000Z). Las fechas sin hora (un check-in, por ejemplo) son strings AAAA-MM-DD.
Los IDs son strings opacos. No los parsees ni asumas un formato.
Los campos opcionales vuelven en null, no ausentes. Un campo que está en el schema está siempre en la respuesta.
stage es una clave, no un título. Cada agencia renombra sus columnas del tablero, así que la clave es lo estable para bifurcar.
Los montos viajan con su moneda al lado. No se normaliza nada por vos.

Cada key pertenece a UNA organización. Ningún request nombra una organización, y nada de lo que leas o escribas sale de la que emitió la key. Si operás varias, necesitás una key por organización.

La API de Trama