Group.svg
Discover our platform
Complete Guide: Obtaining Token, Account UUID, and Creating an Application (App) in Poli

To use the Poli Node in n8n, it is necessary to generate an access token. This token is obtained by making some requests to the Poli API, which can be done using Postman. Postman is a tool for testing and organizing API calls, allowing you to send requests, view responses, and manage collections of endpoints in a practical and secure way. Below is a detailed step-by-step guide:

 

  1. Access Postman
  2. Create a Workspace
    • Inside Postman, click on Workspaces and create a new workspace.
    • The Workspace serves as an “environment” where you will organize all requests related to Poli.
  3. Create a Collection
    • In the Workspace, create a Collection called, for example, Poli API.
    • A Collection is like a folder that will store all the necessary requests.

Now, a step-by-step guide on how to make the API requests:

 

Step 1: Log In

  1. In Postman, create a new request in your collection.
  2. Set the request as POST and enter the URL:
    https://foundation-api.poli.digital/v3/auth/login
  3. In the request body (Body → raw → JSON), insert:
    JSON
    {
    "email": "",
    "password": ""
    }
    Fill in the fields with your Poli platform username and password.
  4. Execute the request to authenticate and receive the necessary data for the next steps.


Step 2: List Accounts

  1. This step must be performed after a successful login.
  2. Create a new request in your collection.
  3. Set it as GET and enter the URL:
    https://foundation-api.poli.digital/v3/accounts?include=status,attributes,organization,addresses,metadata
  4. Execute the request to get the list of available accounts.
  5. In the response, you will get the account_id which will be used in the next step.


 

Step 3: Create Application (Create App)

  1. Now, with the account_id in hand, you can create an application within the account.
  2. Create a new request in the collection.
  3. Set it as POST and enter the URL:
    https://foundationapi.poli.digital/v3/accounts/{{account_id}}/applications?include=attributes
    erge
  4. In the Body → raw → JSON, insert:
    JSON
    {
    "visibility": "PUBLIC",
    "attributes": {
    "name": "AppName",
    "description": "AppDescription",
    "responsible": "ResponsibleName",
    "phone": "+55 62 9999999",
    "email": "Email"
    },
    "attachments": [],
    "settings": [
    {
    "type": "link",
    "name": "webhook",
    "placeholder": "https://example.com/webhook"
    }
    ],
    "resources": []
    }
  5. Fill in the information according to your application, including name, description, responsible person, and contact details.
  6. Execute the request and copy the returned application_uuid (uuid) for the next step.

 

 

Step 4: Generate Token (Create Token)

  1. With the application_uuid, it is now possible to generate the token that will be used in n8n.
  2. Create a new request in the collection.
  3. Set it as POST and enter the URL:
    https://foundationapi.poli.digital/v3/applications/{{application_uuid}}/tokens
  4. In the Body → raw → JSON, insert:
    JSON
    {
    "attributes": { "name": "Application Token" },
    "expires_at": "2025-12-04"
    }
  5. Define a name for the token and the desired expiration date.
  6. Execute the request and copy the generated token.

 

 

This token must be inserted into the authentication field of the Poli Node in n8n.

Now that you have generated the access token, it is essential to store it in a secure location.

 

Attention: After generating the token, it cannot be viewed again on the Poli platform. With the token stored correctly, you will have full access to the functionalities of the Poli Node in n8n, allowing you to create, list, and manage accounts, applications, and automations safely and efficiently.