How to Use GET Nodes (Querying Users, Teams, Channels, and Apps)
After understanding how Poli’s LIST nodes work, which return collections of data (companies, channels, users, teams, etc.), the next step is learning how to use Poli’s GET nodes.
- Purpose: Retrieve detailed information about a specific known record.
- Workflow:
- First, use a LIST node to find the desired identifier (UUID).
- Then, use a GET node to consult the details of that item.
Practical example:
- Use List Channels to find the
account_channel_uuid. - Then use Get Channel to obtain all detailed information about that specific channel.
Prerequisites
- Access Token: obtained in this tutorial.
- Specific UUIDs: e.g.,
account_channel_uuid,user_uuid,team_uuid. - These identifiers are returned by the LIST nodes and then used in the GET nodes.
- Reference article: How to obtain Team UUID, Account Channel UUID, Contact UUID, User UUID, and other identifiers.
Available GET Nodes
1. Get App Data
- Function: Returns detailed information about the account’s applications (apps created for use with tokens and webhooks).
- Required parameter: Only the token.
- Connection with LIST: Unlike the others, this node does not directly depend on a previously listed UUID.
2. Get Channel
- Function: Returns detailed information about a specific company channel.
- Required parameter: Account Channel UUID.
- How to obtain the parameter: Get this UUID using the List Channels node.
- Connection with LIST: First use List Channels → then use Get Channel to get details of the chosen channel.
3. Get User
- Function: Returns detailed information about a specific user.
- Required parameter: User UUID.
- How to obtain the parameter: Get this UUID using the List and Search Users node.
- Connection with LIST: First use List and Search Users → then use Get User to see the details of the selected user.
4. Get Team
- Function: Returns detailed information about a specific team/department within the company.
- Required parameter: Team UUID.
- How to obtain the parameter: Get this UUID using the List Teams node.
- Connection with LIST: First use List Teams → then use Get Team to get details of that team.
