Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

WooCommerce

E-commerce platform built on WordPress

CategoryCommerce
Authenticationcustom
Version0.3.0
Published scopes0 published scopes
Last updatedSeptember 24, 2026

Overview

Connect WooCommerce with Flows360

E-commerce platform built on WordPress

Use the WooCommerce 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 16 actions and 12 triggers.

Available actions

  • Create Customer
  • Create Coupon
  • Create Product
  • Find Customer
  • Find Product
  • Find Coupon
  • Get Customer
  • Update Customer
  • Plus 8 additional declared actions.

Available triggers

  • Product Created
  • Product Updated
  • Product Deleted
  • Order Created
  • Order Updated
  • Order Deleted
  • Plus 6 additional declared triggers.

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: WooCommerce
  • Package: @activepieces/piece-woocommerce@0.3.0
  • Exact artifact digest: sha256:cb2bd338fc6b5bd1d5978164be3746802d60130db137e62a48beb9669b1063a5
  • 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

  • Create Customer (Create Customer), Create a Customer Classification: read.
  • Create Coupon (Create Coupon), Create a coupon Classification: read.
  • Create Product (Create Product), Create a Product Classification: read.
  • Find Customer (Find Customer), Find a Customer Classification: read.
  • Find Product (Find Product), Find a Product Classification: read.
  • Find Coupon (Find Coupon), Find a Coupon Classification: read.
  • Get Customer (Get Customer), Retrieve a single customer by their ID Classification: read.
  • Update Customer (Update Customer), Update a customer name, email or billing details Classification: read.
  • Update Product (Update Product), Update a product, for example its price or stock level Classification: read.
  • Update Coupon (Update Coupon), Update a coupon amount, description, expiry or usage limit Classification: read.
  • Get Order (Get Order), Retrieve a single order by its ID Classification: read.
  • Find Orders (Find Orders), Search orders by status, customer or date Classification: read.
  • Create Order (Create Order), Create an order with one or more line items Classification: read.
  • Update Order (Update Order), Update an order, most commonly its status Classification: read.
  • Add Order Note (Add Order Note), Add a note to an order, optionally visible to the customer Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Product Created, webhook.
  • Product Updated, webhook.
  • Product Deleted, webhook.
  • Order Created, webhook.
  • Order Updated, webhook.
  • Order Deleted, webhook.
  • Coupon Created, webhook.
  • Coupon Updated, webhook.
  • Coupon Deleted, webhook.
  • Customer Created, webhook.
  • Customer Updated, webhook.
  • Customer Deleted, webhook.

Verification

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

Capability summary

Authenticationcustom
Supported objects28
Supported actions16
Triggers12

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Base URL Required
  • Consumer Key Required · protected credential
  • Consumer Secret Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Customer Yes No Create a Customer
Create Coupon Yes No Create a coupon
Create Product Yes No Create a Product
Find Customer Yes No Find a Customer
Find Product Yes No Find a Product
Find Coupon Yes No Find a Coupon
Get Customer Yes No Retrieve a single customer by their ID
Update Customer Yes No Update a customer name, email or billing details
Update Product Yes No Update a product, for example its price or stock level
Update Coupon Yes No Update a coupon amount, description, expiry or usage limit
Get Order Yes No Retrieve a single order by its ID
Find Orders Yes No Search orders by status, customer or date
Create Order Yes No Create an order with one or more line items
Update Order Yes No Update an order, most commonly its status
Add Order Note Yes No Add a note to an order, optionally visible to the customer
Custom API Call Yes No Make a custom API call to a specific endpoint
Product Created Yes No webhook trigger declared by the pinned package.
Product Updated Yes No webhook trigger declared by the pinned package.
Product Deleted Yes No webhook trigger declared by the pinned package.
Order Created Yes No webhook trigger declared by the pinned package.
Order Updated Yes No webhook trigger declared by the pinned package.
Order Deleted Yes No webhook trigger declared by the pinned package.
Coupon Created Yes No webhook trigger declared by the pinned package.
Coupon Updated Yes No webhook trigger declared by the pinned package.
Coupon Deleted Yes No webhook trigger declared by the pinned package.
Customer Created Yes No webhook trigger declared by the pinned package.
Customer Updated Yes No webhook trigger declared by the pinned package.
Customer Deleted Yes No webhook trigger declared by the pinned package.

Supported actions

Create Customer · Read

Create a Customer

create_customer · Risk: low · Retry: safe

Inputs

  • email · string · Required, Enter the email
  • first_name · string · Required, Enter the first name
  • last_name · string · Required, Enter the last name
  • username · string · Required, Enter the username
  • password · string · Required, Enter the password
  • street_address · string · Required, Enter the street address
  • city · string · Required, Enter the city
  • state · string · Required, Enter the state
  • postcode · string · Required, Enter the postcode
  • country · string · Required, Enter the country
  • phone · string · Required, Enter the phone
Create Coupon · Read

Create a coupon

create_coupon · Risk: low · Retry: safe

Inputs

  • code · string · Required, Enter the coupon code
  • discount_type · string · Required, Select the discount type
  • amount · number · Required, Enter the amount
  • minimum_amount · number · Required, Enter the minimum amount
Create Product · Read

Create a Product

create_product · Risk: low · Retry: safe

Inputs

  • name · string · Required, Enter the name
  • type · string · Required, Select the type
  • regular_price · number · Required, Enter the regular price
  • description · string · Required, Enter the description
  • short_description · string · Required, Enter the short description
  • categories · string · Required, Enter the category IDs (comma separated)
  • images · string · Required, Enter the URLs of images you want to upload (comma separated)
Find Customer · Read

Find a Customer

find_customer · Risk: low · Retry: safe

Inputs

  • email · string · Required, Enter the email
Find Product · Read

Find a Product

find_product · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the product ID
Find Coupon · Read

Find a Coupon

find_coupon · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the coupon ID
Get Customer · Read

Retrieve a single customer by their ID

get_customer · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the customer ID
Update Customer · Read

Update a customer name, email or billing details

update_customer · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the customer ID
  • email · string · Optional
  • first_name · string · Optional
  • last_name · string · Optional
  • phone · string · Optional
  • city · string · Optional
  • postcode · string · Optional
  • country · string · Optional, Two-letter country code, e.g. GB
Update Product · Read

Update a product, for example its price or stock level

update_product · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the product ID
  • name · string · Optional
  • regular_price · number · Optional
  • sale_price · number · Optional
  • stock_quantity · number · Optional, Setting this also enables stock management
  • status · string · Optional
  • description · string · Optional
Update Coupon · Read

Update a coupon amount, description, expiry or usage limit

update_coupon · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the coupon ID
  • amount · number · Optional
  • discount_type · string · Optional
  • description · string · Optional
  • date_expires · string · Optional, Date the coupon stops working
  • usage_limit · number · Optional
  • minimum_amount · number · Optional
Get Order · Read

Retrieve a single order by its ID

get_order · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the order ID
Find Orders · Read

Search orders by status, customer or date

find_orders · Risk: low · Retry: safe

Inputs

  • status · string · Optional, Only return orders with this status
  • customer · string · Optional, Only return orders belonging to this customer ID
  • after · string · Optional, Only return orders created after this date
  • per_page · number · Optional, Maximum number of orders to return (1-100, default 10)
Create Order · Read

Create an order with one or more line items

create_order · Risk: low · Retry: safe

Inputs

  • line_items · array · Required, Products to include in the order
  • customer_id · string · Optional, Leave empty for a guest order
  • status · string · Optional, Status the order is created with
  • billing_email · string · Optional, Email address for the order
  • payment_method_title · string · Optional, Human-readable payment method, e.g. Direct bank transfer
Update Order · Read

Update an order, most commonly its status

update_order · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the order ID
  • status · string · Optional, New status for the order
  • customer_note · string · Optional, Note shown to the customer
  • transaction_id · string · Optional, Payment transaction reference
Add Order Note · Read

Add a note to an order, optionally visible to the customer

add_order_note · Risk: low · Retry: safe

Inputs

  • id · string · Required, Enter the order ID
  • note · string · Required, Content of the note
  • customer_note · boolean · Optional, Email the note to the customer and show it on the order page
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

Product Created · Webhook

Triggers when new product is created.

Product Updated · Webhook

Triggers when an existing product is updated.

Product Deleted · Webhook

Triggers when an existing product is deleted.

Order Created · Webhook

Triggers when new order is created.

Order Updated · Webhook

Triggers when an existing order is updated.

Order Deleted · Webhook

Triggers when an existing order is deleted.

Coupon Created · Webhook

Triggers when new coupon is created.

Coupon Updated · Webhook

Triggers when an existing coupon is updated.

Coupon Deleted · Webhook

Triggers when an existing coupon is deleted.

Customer Created · Webhook

Triggers when new customer is created.

Customer Updated · Webhook

Triggers when an existing customer is updated.

Customer Deleted · Webhook

Triggers when an existing customer is deleted.

Setup

Setup

  1. Add the WooCommerce 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:
  • Base URL (baseUrl), required.
  • Consumer Key (consumerKey), required; stored as a sensitive connection value.
  • Consumer Secret (consumerSecret), required; 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-woocommerce@0.3.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 16 actions and 12 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 WooCommerce 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-woocommerce@0.3.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