Developers · Manual

Developers · Introducción

Integra tus sistemas con la API pública v1 de PerformLead.

API pública v1 disponible en B1

La API está aislada por cuenta y usa HTTPS más un token Bearer con permisos explícitos. Ningún endpoint v1 elimina información.

Antes de empezar

Un administrador genera el token

En PerformLead abre Ajustes → Desarrolladores, asigna un nombre, permisos, vencimiento, límite e IP autorizadas.

Guarda el secreto una sola vez

El token completo solo aparece al crearlo. Debe permanecer en un gestor de secretos del servidor.

Usa la base de tu cuenta

Reemplaza {cuenta} por el identificador visible en la URL de PerformLead.

Prueba una consulta sin cambios

Empieza con GET /account y luego consulta los flujos y formularios disponibles.

URL base

https://b1.performlead.com/{cuenta}/api/public/v1

Primera solicitud

curl https://b1.performlead.com/mi-cuenta/api/public/v1/account \
  -H "Authorization: Bearer pl_live_..." \
  -H "Accept: application/json"

Qué puedes integrar

Recurso	Operaciones v1	Permiso
Cuenta	Consultar identidad y totales	`account:read`
Flujos y formularios	Listar y consultar esquema	`flows:read`
Contactos	Listar, buscar y consultar	`contacts:read`
Oportunidades	Listar, consultar, crear y completar datos	`opportunities:read/write`

Contrato OpenAPI 3.0

Descarga el archivo OpenAPI para Postman, Insomnia, Swagger UI o generación de SDK.

Compatibilidad

La versión aparece en la URL. Los cambios compatibles pueden agregar campos; tu integración debe ignorar campos que no reconozca. Un cambio incompatible se publicará en una versión nueva.