Dreamhost icon

Dreamhost

Get data from Dreamhost API

Overview

The node integrates with the Dreamhost API to manage announcement lists, specifically allowing users to list subscribers of a given announcement list. This is useful for scenarios where you want to retrieve and process subscriber data from your Dreamhost-managed mailing lists, such as exporting subscriber emails for marketing campaigns or auditing list membership.

For example, if you have an announcement list named testlist@example.com, this node can fetch all subscribers on that list, enabling you to automate workflows like syncing subscribers with other platforms or generating reports.

Properties

Name Meaning
List Name The name of the announcement list as it appears in your Dreamhost panel (e.g., testlist from testlist@example.com).
Domain The domain part of the announcement list email address (e.g., example.com from testlist@example.com).
Output Format The format in which the subscriber data will be returned. Options include: HTML, JSON, Perl, PHP, Tab, XML, YAML.

Output

The node outputs subscriber data in the selected format under the json output field. The data structure depends on the chosen format:

  • JSON: A structured JSON object representing the list of subscribers.
  • HTML, Perl, PHP, Tab, XML, YAML: Corresponding textual representations of the subscriber data in these formats.

No binary data output is indicated by the source code.

Dependencies

  • Requires an active connection to the Dreamhost API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://api.dreamhost.com.

Troubleshooting

  • Missing or incorrect List Name/Domain: Ensure that the list name and domain exactly match those configured in your Dreamhost panel; otherwise, the API may return errors or empty results.
  • Invalid API credentials: Authentication failures will prevent data retrieval. Verify that the API key credential is correctly set up in n8n.
  • Unsupported output format: Selecting an unsupported format might cause unexpected responses. Use one of the provided options.
  • Network issues: Connectivity problems with the Dreamhost API endpoint can cause timeouts or errors.

Common error messages typically relate to authentication failure, invalid parameters, or network connectivity issues. Resolving them involves checking credentials, verifying input values, and ensuring stable internet access.

Links and References

Discussion