Connecting GoHighLevel is what lets ROASForm push leads and their answers into your CRM, add tags, book calls on your GoHighLevel calendars, and attach uploaded files. It takes about a minute and is done once per subaccount.
One to one. Each ROASForm subaccount connects to exactly one GoHighLevel sub-account (location). If you manage several clients, create one ROASForm subaccount per client and connect each to its own location; the Agency plan lets you create additional subaccounts.
You need a GoHighLevel login with access to that location. GoHighLevel asks you to sign in during the connection. If you normally sign in to GoHighLevel with Google and have no password set, see Can't Connect GHL Because You Use Google Sign-In? first.
In ROASForm, make sure you are in the right subaccount, then open Integrations in the sidebar.
On the GoHighLevel card, click Connect. You are sent to GoHighLevel.
Sign in to GoHighLevel if asked, then choose the sub-account (location) you want this ROASForm subaccount to sync with, and allow the requested permissions.
You are brought back to ROASForm. The card now shows a green Connected badge, and expanding it shows the location name, its Location ID, and when it was connected.
Picked the wrong location? Click Connect again and choose another; the new choice replaces the old one.
The connection is per subaccount, but syncing is per form. Open a form, go to Form Settings → Integrations and set Integration to GoHighLevel. This also turns on Partial Submissions with the default abandon tag. New forms you create afterwards will offer GoHighLevel in that dropdown as well. From here you can:
map answers to contact fields: Mapping Form Answers to GoHighLevel Custom Fields
tag contacts and trigger workflows: How ROASForm Tags Work with GoHighLevel
let visitors book on your calendars: GoHighLevel Calendar Integration
capture people who don't finish: Partial Submissions and Abandon Tags
The Integrations card shows an amber banner with a Reconnect button in two situations:
"Authentication expired. Please reconnect your GHL account." GoHighLevel stopped accepting ROASForm's access, usually because the app was removed in GoHighLevel, permissions were reset, or the account changed. Syncing and bookings are paused until you reconnect; leads that arrived in the meantime can be resent with the sync button on their rows (see Troubleshooting: Leads Not Showing Up in GoHighLevel).
"ROASForm needs new GoHighLevel permissions to sync file uploads to custom fields." Everything keeps working; reconnect once only if you map File Upload questions to GoHighLevel fields.
Reconnecting runs the same Connect flow and keeps all your form settings and mappings.
Expand the GoHighLevel card and click Disconnect. A confirmation explains what happens:
Lead syncing to GoHighLevel stops.
Calendar bookings through GoHighLevel stop working; calendar endings stay in your forms but become inactive until a calendar is selected again.
Existing submissions and bookings are not affected, and nothing is removed from GoHighLevel.
You can reconnect at any time. To switch a subaccount to a different GoHighLevel location, you do not need to disconnect first; just connect again and pick the new location.
Submit a test lead on a published form that has GoHighLevel selected, then look at the row's sync badge in the Submissions tab (it should read Synced) and find the contact in the connected location. If anything is off, Integrations → Logs shows exactly what was sent and what GoHighLevel answered.
