DigitalOcean

List and create droplets on DigitalOcean.

Developer toolsAPI key11 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (11)
create_droplet
list_droplets
create_domain
custom_api_call
delete_domain
delete_droplet
get_domain
get_droplet
list_database_clusters
list_database_events
list_domains
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("digital-ocean", "create_droplet", {
    "creation_mode": "single",
    "name": "<droplet name>",
    "names": [],
    "size": "<size>",
    "image": "<image>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("DigitalOcean answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "digital-ocean-create-droplet",
  name: "DigitalOcean: Create Droplet",
  description: "Calls DigitalOcean when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("digital-ocean", {
      "action": "create_droplet",
      "creation_mode": "single",
      "name": "<droplet name>",
      "names": [],
      "size": "<size>",
      "image": "<image>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/digital-ocean/create_droplet" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"creation_mode":"single","name":"<droplet name>","names":[],"size":"<size>","image":"<image>"}}'

Actions

create_dropletin catalog

Create Droplet. Create a new Droplet or multiple Droplets.

Input	Type	Description
`creation_mode`required	one of "single" \| "multiple"	Create a single Droplet or multiple Droplets at once.
`name`required	text	Name for the Droplet (e.g., example.com).
`names`required	array	Names for multiple Droplets (up to 10).
`region`optional	id (picked from your account)	Region to deploy the Droplet.
`size`required	id (picked from your account)	Droplet size (CPU, RAM, disk).
`image`required	id (picked from your account)	Base image for the Droplet.
`ssh_keys`optional	ids (picked from your account)	SSH keys to embed in the Droplet.
`vpc_uuid`optional	id (picked from your account)	VPC network for the Droplet.
`backups`optional	boolean	Enable automated backups.
`ipv6`optional	boolean	Enable IPv6 networking.
`monitoring`optional	boolean	Install the DigitalOcean monitoring agent.
`tags`optional	array	Tags to apply to the Droplet.
`user_data`optional	long text	Cloud-init script or user data (max 64 KiB).
`with_droplet_agent`optional	boolean	Install agent for web console access.

list_dropletsin catalog

List All Droplets. Retrieve a list of all Droplets in your account.

Input	Type	Description
`per_page`optional	number	Number of Droplets to return per page (1-200).
`page`optional	number	Which page of results to return.
`tag_name`optional	text	Filter Droplets by a specific tag. Cannot be combined with Name or Type.
`name`optional	text	Filter by exact Droplet name (case-insensitive). Cannot be combined with Tag Name.
`type`optional	one of "droplets" \| "gpus"	Filter by Droplet type. Cannot be combined with Tag Name.

create_domain

Create Domain. Add a new domain to your DigitalOcean account.

Input	Type	Description
`name`required	text	The domain name (e.g., example.com).
`ip_address`optional	text	Optional IP address to create an A record pointing to the apex domain.

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

delete_domain

Delete Domain. Remove a domain from your DigitalOcean account.

Input	Type	Description
`domain_name`required	text	The domain name to delete (e.g., example.com).

delete_droplet

Delete Droplet. Delete an existing Droplet.

Input	Type	Description
`droplet_id`required	id (picked from your account)	Select the Droplet to delete.

get_domain

Get Domain. Retrieve details about a specific domain.

Input	Type	Description
`domain_name`required	text	The domain name to retrieve (e.g., example.com).

get_droplet

Get Droplet. Retrieve details about a specific Droplet.

Input	Type	Description
`droplet_id`required	id (picked from your account)	Select the Droplet to retrieve.

list_database_clusters

List Database Clusters. Retrieve a list of all database clusters in your account.

Input	Type	Description
`tag_name`optional	text	Filter database clusters by a specific tag.

list_database_events

List Database Events. Retrieve all event logs for a database cluster.

Input	Type	Description
`database_cluster_uuid`required	id (picked from your account)	Select the database cluster.

list_domains

List All Domains. Retrieve a list of all domains in your account.

Input	Type	Description
`per_page`optional	number	Number of domains to return per page (1-200).
`page`optional	number	Which page of results to return.

Details

Id: digital-ocean
Category: Developer tools
Tags: cloud, infrastructure, hosting, droplets, vps
Package: @activepieces/piece-digital-ocean@0.0.5
Tier: Community