Upnify Documentación API
Inicia aquí · /integraciones

Integraciones

Listar integraciones de la cuenta

GET/integraciones

Lista las integraciones de la cuenta, desde la más reciente, sin incluir las integraciones marcadas como de sistema. Devuelve un arreglo paginado y el total en Row-Count. tipoIntegracion admite varios números separados por comas. config y los tokens pueden contener información confidencial: no los expongas en registros o aplicaciones públicas.

Parámetros

NombreTipoValidaciónDescripción
tokenStringRequeridoEncabezado: Token de sesión vigente obtenido al autenticarte. No lo registres ni lo expongas.
tipoIntegracionStringConsulta: Uno o varios tipos de integración separados por comas, por ejemplo 7,10.
tkIntegracionStringConsulta: Identificador exacto de una integración.
paginaIntegerConsulta: Número de página, desde 1. Con 0 devuelve hasta 1000 registros.
cantidadRegistrosIntegerConsulta: Cantidad de registros por página.

Respuesta

NombreTipoDescripción
indiceIntegerPosición del registro dentro del resultado ordenado.
tipoIntegracionIntegerTipo de integración.
fechaIntegracionStringFecha de creación, sin indicador de zona horaria.
configObjectConfiguración JSON de la integración. Puede contener credenciales; no la publiques. Puede ser null.
tkIntegracionStringIdentificador de la integración.
urlIntegracionStringURL para recibir datos de la integración. Incluye una credencial: no la publiques.
tkSesionIntegracionStringToken completo de integración. No lo registres ni lo expongas.
idFormularioStringIdentificador para recuperar la configuración del formulario.
ultimoUsoStringFecha del último uso; puede ser null.
codigoAutenticacionStringCódigo de autenticación asociado. Puede ser null; trátalo como una credencial.

Solicitud

Consultar integraciones API y HTML

curl --request GET \
  --url 'https://api.upnify.com/integraciones?tipoIntegracion=7%2C10&pagina=1&cantidadRegistros=50' \
  --header 'Accept: application/json' \
  --header 'token: TOKEN-SESION-EJEMPLO'

Respuesta

Integraciones disponibles (HTTP 200)

JSON
[
  {
    "indice": 1,
    "tipoIntegracion": 7,
    "fechaIntegracion": "2026-09-22 09:00:00.000",
    "config": {
      "nombre": "Formulario de ejemplo"
    },
    "tkIntegracion": "AP00000000-0000-4000-8000-000000000001",
    "urlIntegracion": "https://api.salesup.com/v4/integraciones/P01AP00000000-0000-4000-8000-000000000001",
    "tkSesionIntegracion": "P01AP00000000-0000-4000-8000-000000000001",
    "idFormulario": "eyJlIjoxMjMsInQiOiJUT0tFTi1JTlRFR1JBQ0lPTi1FSkVNUExPIn0",
    "ultimoUso": null,
    "codigoAutenticacion": "CODIGO-EJEMPLO"
  }
]