Unipile icon

Unipile

Interact with Unipile API

Overview

This node interacts with the Unipile API to perform various operations related to different resources, including Email. Specifically, the "List Folders" operation under the Email resource retrieves a list of email folders associated with a specified account. This is useful for scenarios where you want to programmatically access or manage email folder structures, such as syncing folders, displaying folder lists in custom applications, or automating email organization tasks.

For example, you might use this node to fetch all folders of an email account before processing emails within those folders or to build a UI that allows users to select which folder to work with.

Properties

Name Meaning
Account ID The ID of the email account to query. This identifies which account's email folders should be listed.

Output

The node outputs JSON data representing the list of email folders retrieved from the Unipile API for the specified account. Each item in the output typically contains details about a folder, such as its name, ID, and possibly other metadata depending on the API response.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Unipile API.
  • Needs an API authentication token configured in the node credentials (referred to generically as an API key credential).
  • The base URL for the API is dynamically set from the credential configuration.
  • The node sends requests with headers specifying JSON content type and expects JSON responses.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID: Ensure the Account ID provided corresponds to a valid account in Unipile.
    • Authentication errors: Verify that the API key credential is correctly configured and has necessary permissions.
    • Network or connectivity problems: Check internet connection and API endpoint availability.
  • Error messages:

    • Unauthorized or 401 errors usually indicate invalid or expired API credentials.
    • 404 errors may mean the specified account does not exist or is inaccessible.
    • Timeout or network errors suggest connectivity issues.

Resolving these typically involves verifying credentials, checking input parameters, and ensuring the Unipile service is operational.

Links and References

Discussion