Pax8 Integration: Customer and Contact Sync
The link between a Pax8 company and a Rev.io customer is the foundation of the Pax8 integration. Contacts, subscriptions, and billing all belong to a linked customer. The customer and contact syncs run on the Schedule set during configuration, every hour by default, and can be turned off with the Sync Customers and Sync Contacts settings.
For each Pax8 company that is not linked yet, the integration looks for the matching Rev.io customer in the following order.
- Exact email match. A Rev.io contact whose email exactly matches the company's email.
- Email domain match. A single customer with the same email domain, such as @acme.com. Common public domains such as gmail.com, yahoo.com, outlook.com, hotmail.com, and icloud.com are ignored.
- Company name match. A customer with a close match to the company name.
The integration does not guess between look-alikes. If a company matches more than one Rev.io customer, the integration blocks that company, sends an alert, and leaves a note on the first matching customer that lists the others. Link the company to the correct customer, and it syncs on the next run. A customer that is already linked is not matched again.
What happens when no customer matches depends on the Customer Creation Policy setting.
| Option | Definition |
| auto | Creates a new Rev.io customer from the Pax8 company's name and address and links it. This is the default. |
| require-existing | Skips the company and its subscriptions until you add or link the customer yourself. |
New customers are assigned the Default Customer Identity and Default Bill Profile chosen during setup. These settings are used only when the integration creates a customer. See the Pax8 Integration: Configuration article for more information.
Once a company is linked, the integration keeps it current on each run. When both the Pax8 company and the Rev.io customer have changed, the Source of Truth - Companies setting decides which system wins.
| Option | Definition |
| Pax8 wins | Pax8 values are written to Rev.io. This is the default. |
| Rev.io wins | Rev.io values are written back to Pax8. |
| Last-modified wins | The record that was edited most recently wins. If both were edited at the same moment, Pax8 wins. |
Contacts on linked companies are matched to Rev.io contacts and kept current. The following rules apply.
- Contacts are matched by name, allowing for small differences in spelling or formatting. A contact with no name is skipped.
- A Pax8 contact that is the primary contact for any role, such as Admin, Technical, or Billing, is set as the primary contact in Rev.io.
- When a linked contact changes, the more recently edited contact updates the other system. Only real changes are written.
- When Pax8 is missing address details that Rev.io requires, the integration fills in placeholder values such as N/A so the contact still syncs. Update these in Rev.io when you can.
For more information about the Pax8 integration, see the following articles.
Pax8 Integration: Overview
Pax8 Integration: Subscription Sync
Pax8 Integration: Notifications and Maintenance