Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Plunk

Open-source email platform for transactional emails, marketing campaigns, and contact management.

CategoryMarketing
Authenticationcustom
Version0.1.0
Published scopes0 published scopes
Last updatedSeptember 23, 2026

Overview

Connect Plunk with Flows360

Open-source email platform for transactional emails, marketing campaigns, and contact management.

Use the Plunk connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 5 actions and no declared triggers.

Available actions

  • Send Transactional Email
  • Track Event
  • Get All Contacts
  • Get Contact
  • Custom API Call

Available triggers

  • No triggers are declared in this pinned package.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Plunk
  • Package: @activepieces/piece-plunk@0.1.0
  • Exact artifact digest: sha256:e167e97075c42d529d24afa4abc9dd5ab8333982c48d401b121a228bc871e37f
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Send Transactional Email (send_transactional_email), Send a transactional email through Plunk. Recipient can be a single address or a comma-separated list. Classification: read.
  • Track Event (track_event), Track a Plunk event for a contact. Plunk auto-creates the contact if they do not exist. Requires the public API key. Classification: read.
  • Get All Contacts (get_all_contacts), Retrieve every contact in your Plunk project. Classification: read.
  • Get Contact (get_contact), Retrieve a single contact by ID. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • No trigger delivery contracts are declared.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects5
Supported actions5
TriggersNone published

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Secret API Key Required · protected credential
  • Public API Key Optional · protected credential

Supported objects

ObjectReadWriteNotes
Send Transactional Email Yes No Send a transactional email through Plunk. Recipient can be a single address or a comma-separated list.
Track Event Yes No Track a Plunk event for a contact. Plunk auto-creates the contact if they do not exist. Requires the public API key.
Get All Contacts Yes No Retrieve every contact in your Plunk project.
Get Contact Yes No Retrieve a single contact by ID.
Custom API Call Yes No Make a custom API call to a specific endpoint

Supported actions

Send Transactional Email · Read

Send a transactional email through Plunk. Recipient can be a single address or a comma-separated list.

send_transactional_email · Risk: low · Retry: safe

Inputs

  • to · string · Required, Recipient email address. For multiple recipients, separate with commas.
  • subject · string · Required
  • body · string · Required, HTML body of the email.
  • name · string · Optional, Optional sender name. Falls back to the project default.
  • from · string · Optional, Optional sender email. Must be a verified address on your Plunk project.
  • reply · string · Optional, Optional reply-to email.
  • subscribed · boolean · Optional, When enabled, Plunk creates the recipient as a subscribed contact if they do not already exist.
Track Event · Read

Track a Plunk event for a contact. Plunk auto-creates the contact if they do not exist. Requires the public API key.

track_event · Risk: low · Retry: safe

Inputs

  • event · string · Required, Identifier of the event being tracked, e.g. `order.completed`.
  • email · string · Required, Email address of the contact the event belongs to.
  • subscribed · boolean · Optional, When enabled, contacts auto-created by this event will be marked as subscribed.
  • data · object · Optional, Optional metadata stored alongside the event.
Get All Contacts · Read

Retrieve every contact in your Plunk project.

get_all_contacts · Risk: low · Retry: safe

Get Contact · Read

Retrieve a single contact by ID.

get_contact · Risk: low · Retry: safe

Inputs

  • contactId · string · Required, The Plunk contact ID.
Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Setup

Setup

  1. Add the Plunk connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Secret API Key (secretKey), required; stored as a sensitive connection value.
  • Public API Key (publicKey), optional; stored as a sensitive connection value.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-plunk@0.1.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 5 actions and 0 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Plunk connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-plunk@0.1.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com