Articles on: Integrations
This article is also available in:

How to integrate WooCommerce with Trustmary

Quick steps


  1. In WordPress, go to Plugins → Add New, search for Trustmary Integration for WooCommerce, then click Install Now and Activate.
  2. In Trustmary, go to Settings → Developers and click Add new under API keys. Copy the key.
  3. In WordPress, go to WooCommerce → Settings → Trustmary, paste the key into API Key and click Test API connection.
  4. Click Add trigger, pick the order statuses and the Trustmary lists, then click Save changes.
  5. Place a test order and move it to one of those statuses. The customer appears in the list in Trustmary.


The plugin sends the contact details of a WooCommerce order to Trustmary when the order reaches a chosen status. A list connected to a survey then sends that survey, so review requests go out without any manual export. The setup takes about ten minutes.


Requires: WordPress 5.8 or later, WooCommerce 5.0 or later, PHP 7.4 or later, and a Trustmary account.


Step 1 — Install the plugin


In the WordPress admin, go to Plugins → Add New and search for Trustmary Integration for WooCommerce. Click Install Now, then Activate. A Trustmary tab appears under WooCommerce → Settings.


Step 2 — Create an API key in Trustmary


In Trustmary, go to Settings → Developers. Under API keys, click Add new, give the key a name and copy it.


The API keys section of the Developers page, with Add new on the right.


The key is shown only once. Treat it like a password: it gives write access to the account's contacts.


Step 3 — Connect the plugin


Back in WordPress, go to WooCommerce → Settings → Trustmary. Paste the key into API Key and click Test API connection. A successful test shows the name of the Trustmary organization in the Connection card and saves the key, so nothing else needs saving on this page yet.


The Connection card after a successful test, showing Connected and the organization name.


Step 4 — Create a trigger


Click Add trigger. A trigger decides when an order is sent, which orders qualify, where the contact goes and which data is included. The editor walks through the four parts in order.


The trigger editor: When, Filter, Action and Field mapping.


  1. When — one or more order statuses, for example Completed. The trigger runs when an order moves into any of them.
  2. Filter (optional) — products, billing country, order total and first order only. All conditions must be met; for an either/or, create another trigger.
  3. Action — the Trustmary lists the contact is added to. Click Refresh to load the lists from the account. A list connected to a survey sends it according to that list's settings. Send again is off by default, so each trigger sends an order once.
  4. Field mapping — which order data goes to which contact field. Email, first name, last name, order ID, order status and product names are mapped from the start. Create default fields adds the plugin's custom fields to the Trustmary account with one click.


Give the trigger a name, keep Run this trigger checked and click Save changes. The trigger shows as Active in the list.


To send a different survey for each product, create one trigger per product: set the product filter and choose the list connected to that product's survey. All active triggers run in parallel, and one order can match several.


Step 5 — Test with an order


Place a test order and move it to a status chosen in the trigger. Sending runs in the background, so checkout never waits for Trustmary, and the customer appears in the chosen list usually within a minute.


If the list is connected to a survey, the survey is sent to the test contact as well.


Troubleshooting


The contact does not appear in Trustmary. Go to WooCommerce → Status → Logs and pick the woocommerce-trustmary source. Every status change is logged with the triggers that matched, and the reason the others did not.


The WooCommerce log list, filtered to the woocommerce-trustmary source.


A trigger shows Needs attention. A product in its filter has been deleted, or a list no longer exists in Trustmary. The trigger is paused until the filter or the list is fixed in the editor.


The same customer is sent several times. Each trigger sends an order only once unless Send again is enabled for it. Contacts are matched by email, so the same customer is updated, not duplicated.


The settings page looks different after an update. Version 2.0 replaced the single settings form with triggers. The earlier settings were moved to a trigger named Default that works exactly as before; edit it or add more triggers next to it.


Developers who want to change the data that is sent can use the plugin's filters, documented on the plugin's WordPress.org page.

Updated on: 11/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!