Para utilizar el Poli Node en n8n, es necesario generar un token de acceso. Este token se obtiene realizando algunas solicitudes en la API de Poli, que pueden hacerse utilizando Postman.
Postman es una herramienta para probar y organizar llamadas de APIs, permitiendo enviar solicitudes, visualizar respuestas y gestionar colecciones de endpoints de forma práctica y segura.

A continuación, un paso a paso detallado:

Acceder a Postman

• Cree una cuenta gratuita o inicie sesión con una existente.
• [Enlace Postman]

Crear un Workspace

• Dentro de Postman, haga clic en Workspaces y cree un nuevo espacio de trabajo.
• El Workspace sirve como un “entorno” donde organizará todas las solicitudes relacionadas con Poli.

Crear una Collection

• En el Workspace, cree una Collection llamada, por ejemplo, Poli API.
• La Collection es como una carpeta que guardará todas las solicitudes necesarias.

Paso 1: Hacer Login

1. En Postman, cree una nueva solicitud en su colección.
2. Configure la solicitud como POST e inserte la URL:

   https://foundation-api.poli.digital/v3/auth/login
   

3. En el cuerpo de la solicitud (Body → raw → JSON), inserte:

   {
     "email": "",
     "password": ""
   }
   

4. Rellene los campos con su usuario y contraseña de la plataforma Poli.
5. Ejecute la solicitud para autenticar y recibir los datos necesarios para los próximos pasos.

Paso 2: Listar Cuentas

1. Este paso debe realizarse después de un login exitoso.
2. Cree una nueva solicitud en su colección.
3. Configure como GET e inserte la URL:

   https://foundation-api.poli.digital/v3/accounts?include=status,attributes,organization,addresses,metadata
   

4. Ejecute la solicitud para obtener la lista de cuentas disponibles.
5. En la respuesta, recibirá el account_id que será usado en el siguiente paso.

Paso 3: Crear Aplicación (Create App)

1. Ahora, con el account_id en mano, es posible crear una aplicación dentro de la cuenta.
2. Cree una nueva solicitud en la colección.
3. Configure como POST e inserte la URL:

   https://foundationapi.poli.digital/v3/accounts/{{account_id}}/applications?include=attributes
   

4. En Body → raw → JSON, inserte:

   {
     "visibility": "PUBLIC",
     "attributes": {
       "name": "NombreDelAPP",
       "description": "DescripciónDelAPP",
       "responsible": "NombreDelResponsable",
       "phone": "+55 62 9999999",
       "email": "Email"
     },
     "attachments": [],
     "settings": [
       {
         "type": "link",
         "name": "webhook",
         "placeholder": "https://example.com/webhook"
       }
     ],
     "resources": []
   }
   

5. Complete la información de acuerdo con su aplicación, incluyendo nombre, descripción, responsable y datos de contacto.
6. Ejecute la solicitud y copie el application_uuid (uuid) retornado para el siguiente paso.

Paso 4: Generar Token (Create Token)

1. Con el application_uuid, ahora es posible generar el token que será usado en n8n.
2. Cree una nueva solicitud en la colección.
3. Configure como POST e inserte la URL:

   https://foundationapi.poli.digital/v3/applications/{{application_uuid}}/tokens
   

4. En Body → raw → JSON, inserte:

   {
     "attributes": { "name": "Application Token" },
     "expires_at": "2025-12-04"
   }

5. Defina un nombre para el token y la fecha de expiración deseada.
6. Ejecute la solicitud y copie el token generado.
7. Este token debe insertarse en el campo de autenticación del Poli Node en n8n.

Ahora que ha generado el token de acceso, es fundamental almacenarlo en un lugar seguro.
⚠ Atención: Después de generar el token, no podrá ser visualizado nuevamente en la plataforma Poli.

Con el token almacenado correctamente, tendrá acceso total a las funcionalidades del Poli Node en n8n, pudiendo crear, listar y gestionar cuentas, aplicaciones y automatizaciones de forma segura y eficiente.