Poli icon

Poli

Node principal para interagir com a API da Poli

Tag → List Tags

AI-generated

Overview

This node operation lists tags associated with a specified account in the Poli API. It supports filtering and pagination options, allowing users to search for tags by text, order the results, specify the page number, set the number of tags per page, and include additional related data such as status, category, attributes, contacts, and metadata. This operation is useful for managing and retrieving tag information within an account, for example, to display tags in a user interface or to process tags in automation workflows.

Use Case Examples

  1. Retrieve all tags for a given account to display in a dashboard.
  2. Search for tags containing specific text to filter relevant tags for a marketing campaign.
  3. Paginate through tags to process them in batches for data synchronization.

Properties

Name Meaning
Account UUID The unique identifier of the account for which to list tags. This is a required string input.
Options Additional optional parameters to refine the tag listing, including search text, order, pagination (page and perPage), raw query string, and which related data to include (status, category, attributes, contacts, metadata).

Output

JSON

  • tags - Array of tag objects returned from the API, containing tag details and optionally related data as specified in the include options.

Dependencies

  • Poli API with an API key credential

Troubleshooting

  • Ensure the Account UUID is provided and valid; missing or incorrect account ID will cause errors.
  • Verify that the API credentials are correctly configured and have permissions to access tag data.
  • Check the format and values of optional parameters like page and perPage to avoid invalid requests.
  • If the operation fails, review error messages for details on missing or invalid parameters or API issues.

Discussion