Actions14
Overview
This node integrates with DigitalOcean's API to manage cloud resources, specifically focusing here on creating Droplets (virtual machines). It allows users to create new Droplets by specifying parameters such as the droplet name, size, image type (application or distribution), and additional configuration options like region, SSH keys, backups, IPv6, monitoring, and tags.
Common scenarios include automating infrastructure provisioning, scaling applications by programmatically creating new servers, or integrating DigitalOcean resource management into broader workflows. For example, a user might automate the creation of a new Droplet whenever a new project is initiated or scale out compute resources based on demand triggers.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with DigitalOcean API: either using an Access Token or OAuth2. |
| Name | The name assigned to the new Droplet being created. |
| Use Application Image | Boolean flag indicating whether to use an application image (pre-configured app environments) or a standard distribution image (OS images). |
| Application Image Name or ID | When using an application image, select from available application images or specify an ID via expression. |
| Image Name or ID | When not using an application image, select from available distribution images or specify an ID via expression. |
| Size Name or ID | The size (resource allocation) for the Droplet, selected from available sizes or specified by ID. |
| Additional Fields | A collection of optional settings: - Backups: Enable automatic backups (boolean). - Enable IPv6: Enable IPv6 networking (boolean). - Monitoring: Enable monitoring services (boolean). - Region Name or ID: Select the data center region. - SSH Keys: Assign SSH keys by selecting from existing keys. - Tags: Add one or more tags to the Droplet, separated by commas. |
Output
The output JSON contains the full details of the newly created Droplet as returned by the DigitalOcean API. This includes all metadata about the Droplet such as its ID, name, status, IP addresses, region, size, image details, and any other properties set during creation.
No binary data output is produced by this operation.
Dependencies
- Requires a valid DigitalOcean API authentication credential, either an access token or OAuth2 credentials.
- The node uses internal helper methods to fetch lists of sizes, images, regions, SSH keys, and tags dynamically for property selection.
- No additional external dependencies beyond the DigitalOcean API and n8n environment are required.
Troubleshooting
Error: Both Tag Name and Name used in filters
The DigitalOcean API does not allow filtering droplets by both tag name and droplet name simultaneously. If you encounter this error, remove one of these filters.Invalid or missing authentication
Ensure that the provided API key or OAuth2 token is valid and has sufficient permissions to create Droplets.Invalid image or size selection
Make sure the selected image ID or slug and size ID or slug exist and are compatible. Using expressions incorrectly may cause invalid values.Region not specified or invalid
If the region is omitted or invalid, the API may reject the request. Always specify a valid region if required.API rate limits
Frequent requests may hit DigitalOcean API rate limits. Implement retry logic or reduce request frequency if errors occur.