Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Plausible Analytics

Privacy-friendly website analytics

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

Overview

Connect Plausible Analytics with Flows360

Privacy-friendly website analytics

Use the Plausible Analytics 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 20 actions and 1 trigger.

Available actions

  • Get Realtime Visitors
  • Get Aggregate Stats
  • Get Traffic Breakdown
  • List Sites
  • Get Site
  • Create Site
  • Update Site
  • Delete Site
  • Plus 12 additional declared actions.

Available triggers

  • Traffic Spike

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: Plausible Analytics
  • Package: @activepieces/piece-plausible@0.2.0
  • Exact artifact digest: sha256:02b470336cc58dbac2af7c2867c40fab260a80c8fc37da1ab53de3369dd3d014
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

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

Action contracts

  • Get Realtime Visitors (get_realtime_visitors), Get the number of current visitors on your site Classification: read.
  • Get Aggregate Stats (get_aggregate_stats), Get aggregated analytics metrics for a time period Classification: read.
  • Get Traffic Breakdown (get_breakdown), Break down traffic by page, source, country, or other dimensions Classification: read.
  • List Sites (list_sites), Get a list of sites your Plausible account can access Classification: read.
  • Get Site (get_site), Get details of a site including tracker script configuration Classification: read.
  • Create Site (create_site), Create a new site in your Plausible account Classification: read.
  • Update Site (update_site), Update an existing site in your Plausible account Classification: read.
  • Delete Site (delete_site), Delete a site and all its data from your Plausible account. This action is permanent and may take up to 48 hours to complete. Classification: read.
  • Create Shared Link (create_shared_link), Find or create a shared link for a site Classification: read.
  • List Goals (list_goals), Get a list of goals for a site Classification: read.
  • Create Goal (create_goal), Find or create a goal for a site Classification: read.
  • Delete Goal (delete_goal), Delete a goal from a site Classification: read.
  • List Custom Properties (list_custom_properties), Get a list of custom properties for a site Classification: read.
  • Create Custom Property (create_custom_property), Create a custom property for a site Classification: read.
  • Delete Custom Property (delete_custom_property), Delete a custom property from a site Classification: read.
  • List Guests (list_guests), Get a list of guests for a site Classification: read.
  • Invite Guest (invite_guest), Invite a guest to access a site or find an existing invitation Classification: read.
  • Remove Guest (remove_guest), Remove a guest or invitation from a site Classification: read.
  • List Teams (list_teams), Get a list of teams your Plausible account can access Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Traffic Spike, polling.

Verification

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

Capability summary

Authenticationcustom
Supported objects21
Supported actions20
Triggers1

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
Get Realtime Visitors Yes No Get the number of current visitors on your site
Get Aggregate Stats Yes No Get aggregated analytics metrics for a time period
Get Traffic Breakdown Yes No Break down traffic by page, source, country, or other dimensions
List Sites Yes No Get a list of sites your Plausible account can access
Get Site Yes No Get details of a site including tracker script configuration
Create Site Yes No Create a new site in your Plausible account
Update Site Yes No Update an existing site in your Plausible account
Delete Site Yes No Delete a site and all its data from your Plausible account. This action is permanent and may take up to 48 hours to complete.
Create Shared Link Yes No Find or create a shared link for a site
List Goals Yes No Get a list of goals for a site
Create Goal Yes No Find or create a goal for a site
Delete Goal Yes No Delete a goal from a site
List Custom Properties Yes No Get a list of custom properties for a site
Create Custom Property Yes No Create a custom property for a site
Delete Custom Property Yes No Delete a custom property from a site
List Guests Yes No Get a list of guests for a site
Invite Guest Yes No Invite a guest to access a site or find an existing invitation
Remove Guest Yes No Remove a guest or invitation from a site
List Teams Yes No Get a list of teams your Plausible account can access
Custom API Call Yes No Make a custom API call to a specific endpoint
Traffic Spike Yes No polling trigger declared by the pinned package.

Supported actions

Get Realtime Visitors · Read

Get the number of current visitors on your site

get_realtime_visitors · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Get Aggregate Stats · Read

Get aggregated analytics metrics for a time period

get_aggregate_stats · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • period · string · Required
  • metrics · array · Required
Get Traffic Breakdown · Read

Break down traffic by page, source, country, or other dimensions

get_breakdown · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • period · string · Required
  • property · string · Required
  • limit · number · Optional
List Sites · Read

Get a list of sites your Plausible account can access

list_sites · Risk: low · Retry: safe

Get Site · Read

Get details of a site including tracker script configuration

get_site · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Create Site · Read

Create a new site in your Plausible account

create_site · Risk: low · Retry: safe

Inputs

  • domain · string · Required, Domain of the site (must be globally unique)
  • timezone · string · Optional, Timezone name according to IANA database (e.g., Europe/London). Defaults to Etc/UTC
  • team_id · string · Optional, Select a team
  • track_404_pages · boolean · Optional, Enable tracking of 404 error pages
  • hash_based_routing · boolean · Optional, Enable hash-based routing for single-page applications
  • outbound_links · boolean · Optional, Track clicks on outbound links
  • file_downloads · boolean · Optional, Track file downloads
  • form_submissions · boolean · Optional, Track form submissions
Update Site · Read

Update an existing site in your Plausible account

update_site · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • new_domain · string · Optional, New domain name for the site (leave empty to keep current)
  • track_404_pages · boolean · Optional, Enable tracking of 404 error pages
  • hash_based_routing · boolean · Optional, Enable hash-based routing for single-page applications
  • outbound_links · boolean · Optional, Track clicks on outbound links
  • file_downloads · boolean · Optional, Track file downloads
  • form_submissions · boolean · Optional, Track form submissions
Delete Site · Read

Delete a site and all its data from your Plausible account. This action is permanent and may take up to 48 hours to complete.

delete_site · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Create Shared Link · Read

Find or create a shared link for a site

create_shared_link · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • name · string · Required, Name of the shared link (e.g., Wordpress)
List Goals · Read

Get a list of goals for a site

list_goals · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Create Goal · Read

Find or create a goal for a site

create_goal · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • goal_type · string · Required, Type of goal to create
  • event_name · string · Optional, Name of the event (required if goal type is Event)
  • page_path · string · Optional, Page path to track (required if goal type is Page). Supports wildcards.
  • display_name · string · Optional, Custom display name for the goal in the dashboard
Delete Goal · Read

Delete a goal from a site

delete_goal · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • goal_id · string · Required, Select a goal
List Custom Properties · Read

Get a list of custom properties for a site

list_custom_properties · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Create Custom Property · Read

Create a custom property for a site

create_custom_property · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • property · string · Required, Name of the custom property
Delete Custom Property · Read

Delete a custom property from a site

delete_custom_property · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • property · string · Required, Select a custom property
List Guests · Read

Get a list of guests for a site

list_guests · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
Invite Guest · Read

Invite a guest to access a site or find an existing invitation

invite_guest · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • email · string · Required, Guest's email address
  • role · string · Required, Role to assign to the guest
Remove Guest · Read

Remove a guest or invitation from a site

remove_guest · Risk: low · Retry: safe

Inputs

  • site_id · string · Required, Select a site
  • email · string · Required, Select a guest
List Teams · Read

Get a list of teams your Plausible account can access

list_teams · Risk: low · Retry: safe

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.

Triggers

Traffic Spike · Poll

Triggers once when current visitors exceed a threshold, then resets when they drop below it

Inputs

  • site_id · string
  • threshold · number

Setup

Setup

  1. Add the Plausible Analytics 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:
  • No provider credential fields are declared by the pinned package.
  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-plausible@0.2.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 20 actions and 1 trigger 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 Plausible Analytics 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-plausible@0.2.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