Dreamhost icon

Dreamhost

Get data from Dreamhost API

Overview

This node integrates with the Dreamhost API to manage DNS records. Specifically, the "Add A New DNS Record" operation allows users to add a new DNS record to a specified domain managed by Dreamhost. This is useful for automating DNS management tasks such as adding A, AAAA, CNAME, TXT, or other types of DNS records without manually logging into the Dreamhost control panel.

Common scenarios include:

  • Automatically provisioning DNS records when deploying new services.
  • Managing DNS entries programmatically as part of CI/CD pipelines.
  • Adding comments to DNS records for documentation purposes.

Example: Adding an A record for example.com pointing to an IP address 192.0.2.1 with an optional comment describing the purpose of the record.

Properties

Name Meaning
Record The domain name you are adding the DNS record to (e.g., example.com).
Type The DNS record type. Options: A, AAAA, CNAME, NAPTR, NS, SRV, TXT.
Value The value of the DNS record (e.g., IP address for A record, hostname for CNAME).
Comment Optional comment for the new DNS record to provide additional context or notes.
Output Format The format in which the response data will be returned. Options: HTML, JSON, Perl, PHP, Tab, XML, YAML.

Output

The node outputs the response from the Dreamhost API after attempting to add the DNS record. The output is available in the json field and its structure depends on the selected output format (default is JSON). It typically contains information about the success or failure of the request and details of the added record.

If binary data were involved (not indicated here), it would represent file contents or similar, but this node deals only with JSON or text-based responses.

Dependencies

  • Requires an active Dreamhost account with API access enabled.
  • Needs an API key credential configured in n8n to authenticate requests to the Dreamhost API.
  • Internet connectivity to reach https://api.dreamhost.com.

Troubleshooting

  • Invalid API Key or Authentication Failure: Ensure the API key credential is correctly set up and has sufficient permissions.
  • Invalid Domain or Record Data: Verify that the domain exists in your Dreamhost account and that the record type and value conform to DNS standards.
  • API Rate Limits or Service Unavailability: If requests fail repeatedly, check Dreamhost service status or consider rate limiting in workflows.
  • Unexpected Response Format: If the output format is changed from JSON to another format, ensure downstream nodes can handle that format.

Links and References

Discussion