Unipile icon

Unipile

Interact with Unipile API

Overview

The node provides integration with the Unipile API, allowing users to interact with various Unipile resources. Specifically, for the Email resource and the Get Folder operation, it retrieves details about a specific email folder by its ID. This is useful in scenarios where you want to programmatically access metadata or properties of an email folder within Unipile, such as fetching folder names, counts, or other folder-specific information.

Practical examples include:

  • Automating email management workflows by retrieving folder details before processing emails.
  • Synchronizing folder metadata with other systems.
  • Displaying folder information in custom dashboards or reports.

Properties

Name Meaning
Folder ID The unique identifier of the email folder to retrieve. This is required.
Additional Fields Optional extra parameters; currently supports:
- Account ID The ID of the account when using provider UID, sent as a query parameter account_id.

Output

The node outputs JSON data representing the details of the requested email folder. This typically includes folder metadata such as folder name, ID, and possibly other attributes provided by the Unipile API related to that folder.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Unipile API via an API key credential configured in n8n.
  • The base URL for API requests is taken from the credential's DSN (Data Source Name).
  • Proper permissions on the Unipile account to access email folders are necessary.

Troubleshooting

  • Missing or invalid Folder ID: The operation requires a valid folder ID. Ensure the Folder ID input is correctly set and corresponds to an existing folder.
  • Authentication errors: If the API key or credentials are incorrect or expired, the node will fail to authenticate. Verify the API key and update if needed.
  • Account ID mismatch: When using the optional Account ID field, ensure it matches the provider's expected account identifier; otherwise, the request may return no data or errors.
  • Network or API downtime: Connectivity issues or Unipile service outages can cause failures. Check network connectivity and Unipile status.

Common error messages might include unauthorized access, not found errors for invalid folder IDs, or bad request errors if parameters are malformed.

Links and References

Discussion