Save booking form customers to HighLevel contacts

With a HighLevel connection chosen, each booking adds the customer to HighLevel as a contact, tagged with the service they booked. Without one, nothing is sent to HighLevel.

Before you start

  • This needs a booking form subscription. Without one the page says "Want to save customer details to HighLevel contacts?" and there is no Save button, and the booking does nothing in HighLevel.
  • A HighLevel connection has to exist under Integrations in the main dashboard menu. Add a HighLevel connection there and click Login with HighLevel. Agency accounts cannot be connected, so connect a sub-account. The page also says you may need to log out of HighLevel before connecting.
  • The page offers HighLevel connections only. A connection to any other tool is not in the list.

Step by step

  1. Open your form from Forms, then the Integrations tab, then HighLevel.
  2. Choose a connection in HighLevel integration. Each one is listed by its name, with the connected user after it where Formpiece has one.
  3. Click Save. The page says "HighLevel integration updated."

To stop sending contacts, clear the box with its clear button and click Save.

Go to integrations at the foot of the page takes you to the connections list, for a new login. A HighLevel login cannot be refreshed in place. The connection's own page says you need to create a new HighLevel integration to refresh your login. After you do, choose it here.

What is sent to HighLevel

The booking is saved to Simpro first. Then Formpiece adds or updates a HighLevel contact in the location you connected, with these fields:

HighLevel contact Taken from the booking
First name The customer's first name
Last name Surname
Email Email
Phone Phone
Name The company name, only when the customer gave one
Address, City, State, Postal code The site address fields, each only when filled in
Tags The label of the service they booked
Source Formpiece, on every contact

HighLevel decides whether the contact is new or an existing one that is updated. Formpiece sends one upsert request and keeps what HighLevel returns. The HighLevel contact ID is saved on the booking and shows under HighLevel Integration on the booking's page in Bookings, in a Contact row.

Nothing from HighLevel is written back to Simpro.

When it goes wrong

There is no contact in HighLevel

A HighLevel failure never stops the booking. Formpiece logs it and carries on, and nothing in the dashboard reports it. The Contact row on the booking shows a dash. These leave no contact:

  • The connection has no location. The sign-in has to be made against a sub-account.
  • The connection has no access token.
  • The token has expired and could not be refreshed. Create a new HighLevel connection and choose it on this page.
  • The account has no booking form subscription.

The list is empty

No HighLevel connection exists on the account. Create one under Integrations first.