🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 30, 2026

How to Send WooCommerce Orders to Planfix Automatically

GravityExtra
How to Send WooCommerce Orders to Planfix Automatically

Planfix is where many teams run their projects, tasks and client relationships. WooCommerce is where those same teams sell products, services and subscriptions. When the two do not talk to each other, someone ends up opening every new order, copying the customer’s name, email and phone into Planfix, and pasting the order details into a note. It works for a handful of orders a week. It breaks the moment a sale comes in at night, a team member is on holiday, or a returning customer gets created twice.

This guide explains how to send WooCommerce customers and orders to Planfix automatically with the WooCommerce Planfix Integration Premium Add-on: what it sends, how to set it up step by step, how it avoids duplicate contacts, and what happens when the Planfix API is not reachable.

Why Connect WooCommerce Orders to Planfix?

  • Sales become work immediately. A new order often means work for your team: an onboarding call, a delivery, a service visit or a follow-up. When the customer appears in Planfix right away, the person responsible can act on it without waiting for someone to copy the data.
  • One customer record. Customers who buy again should not appear in Planfix twice. A clean contact list makes history, comments and follow-ups easy to find.
  • Grouped by what they bought. Contact groups let you separate, for example, consulting clients from product buyers, or wholesale accounts from retail customers.
  • Fewer mistakes. Every manual copy is a chance to mistype an email address or forget a phone number.

Your Options

1. Copy orders by hand

Fine for very small shops. It does not scale, it depends on someone remembering, and duplicates creep in because nobody checks whether the customer already exists.

2. An automation platform such as Zapier or Make

General automation platforms can watch WooCommerce and call Planfix. They are flexible, but every order becomes a billed task, you have to build the “does this contact already exist?” logic yourself, and failed runs are reported in a separate dashboard instead of on the order.

3. Custom code

A developer can hook into WooCommerce order status changes and call the Planfix REST API. The first version is quick. Retrying failed calls, keeping tokens out of logs, avoiding duplicates and giving shop managers a way to resend an order take much longer.

4. A dedicated add-on

The WooCommerce Planfix Integration Premium Add-on runs inside your WordPress site, sends each order straight to the Planfix REST API, and writes the result on the order itself.

What the Add-on Sends to Planfix

When an order is paid, the add-on looks the customer up in Planfix by email address. Then one of two things happens:

  • New customer: a Planfix contact is created with first name, last name, email and phone. The order details (order number, products and total) go into the contact description. If you mapped a contact group for the product, the contact is placed in that group.
  • Existing customer: no second contact is created. The order is added as a comment on the existing contact, so the purchase history stays on one record.

You can also map extra order fields. On the left you pick a WooCommerce order field such as billing_company; on the right you enter a Planfix field: position, address, site, or the number of a Planfix custom field.

Planfix contacts belong to contact groups rather than tag lists, so the product mapping in this add-on is “product to contact group”. That keeps the integration simple and matches how Planfix itself organises contacts.

Step-by-Step Setup

Step 1: Install and activate the licence

Install the add-on zip from your GravityExtra account under Plugins > Add New > Upload Plugin and activate it. WooCommerce must be active. Open WooCommerce > Planfix and enter your GravityExtra licence key. The sync features run with an active licence; without a key the add-on shows only the licence form and sends nothing. The same key delivers updates.

Step 2: Create a Planfix REST API token

In Planfix, go to Account management > Integrations > REST API and add a token with read and write access to contacts. Copy the token. You will also need your account name: the part of your Planfix address before .planfix.com.

Step 3: Enter the API credentials and test

On the API Credentials tab, enter the account name and the token, save, and click Test Connection. The test only pings the Planfix REST API; it does not create a contact. After saving, the token field shows “Saved. Leave blank to keep it.” and the token is never printed back on the page.

Step 4: Map products to contact groups

Open Product Feeds. Each row links a WooCommerce product (or Every product) to a Planfix contact group ID. Click Fetch to load your groups from Planfix so you do not have to look up the numbers. The group is optional: leave it empty and new contacts are created without a group.

Some examples:

  • “Website audit” product → group “Audit clients”.
  • “Monthly support plan” product → group “Support customers”.
  • Every product → group “Shop customers”, as a catch-all.

Step 5: Choose when orders are sent

By default an order is sent when its status becomes completed. Tick On processing on a feed row to send it as soon as the payment is received (early sync). This is useful for services where your team should start before the order is marked complete.

Step 6: Place a test order

Place an order for a mapped product and complete it. Open the order in WooCommerce: an order note starting with [Planfix] confirms what was sent. In Planfix you will see the new contact in the chosen group. Place a second order with the same email and you will see a comment on the same contact instead of a duplicate.

What Happens When Something Goes Wrong

APIs are not always available, tokens expire and settings get changed. The add-on is built so that a problem never loses an order silently:

  • Order notes: every result, success or failure, is written as an order note, so the shop manager sees it where they already work.
  • Automatic retries: a failed call is retried by WooCommerce’s Action Scheduler after 5 minutes, 15 minutes and 1 hour. If it still fails, a final note explains the reason.
  • Send again: after fixing the cause (for example a new token), open the order and choose Send to Planfix again from the order actions.
  • Once per order: each order is sent once per feed row, so saving an order again or changing its status back and forth does not create repeats.
  • Logs: the Logs tab lists the last 200 sync events with time, level and message. The full log is under WooCommerce > Status > Logs, source woocommerce-planfix-addon. API tokens are never written to either log.

A refund or cancellation adds an order note only. Planfix has no matching “remove from group” action for this case, and deleting customer records automatically would be risky, so nothing is deleted in Planfix.

Tips for a Clean Planfix Account

  • Start with one catch-all row. An “Every product” row with a general group makes sure every customer arrives. Add product-specific rows later.
  • Use custom fields for business data. If you sell to companies, map billing_company to a Planfix custom field so your team can filter by company.
  • Decide on early sync per product. Physical goods usually wait for completed; services and bookings benefit from On processing.
  • Check the order notes after changes. Whenever you change the token or the mapping, place one test order and read the note.
  • Keep the token scoped. Give the REST API token access to contacts only; the add-on needs nothing else.

Frequently Asked Questions

Does it work with guest checkout?

Yes. The add-on uses the billing email of the order, so guest orders are sent the same way as orders from registered customers.

Will a returning customer be duplicated?

No. The customer is looked up by email first. If the contact exists, the new order becomes a comment on that contact.

Can one product go to several groups?

A Planfix contact belongs to one contact group, so map each product to one group. Each feed row sends the order once; if a second row matches, it finds the contact by email and adds the order as a comment.

Does it need a Planfix paid plan?

You need a Planfix account where you can create a REST API token under Account management > Integrations.

Which versions are supported?

WordPress 6.0 or newer, WooCommerce 8.0 or newer (tested up to 11.2) and PHP 7.4 or newer.

Is a licence required?

Yes. The features work with an active GravityExtra licence key, which also delivers automatic updates.

Get Started

If your team already lives in Planfix, sending every WooCommerce customer there automatically saves time on every order and keeps one clean record per customer. Get the WooCommerce Planfix Integration Premium Add-on, add your token, map your products to contact groups and place a test order. The whole setup takes about ten minutes.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr