Integration with HubSpot ​

Every customer who connects to your Wi-Fi is a potential marketing contact. If you use HubSpot as your CRM, this integration lets you push your Powerlynx customers into HubSpot as contacts — so you can follow up with offers, newsletters, and campaigns using the data you already collect at the splash page.

The sync is one-way: Powerlynx → HubSpot. Powerlynx stays the source of truth for your customers; HubSpot receives a copy as marketing contacts. You connect your HubSpot account, decide which customer fields map to which HubSpot properties, and push your customers whenever you want with a single button.

The integration lives under Config → Integrations → HubSpot and is organised into three tabs: Connection, Field mapping, and Synchronization.

Connecting HubSpot ​

To let Powerlynx talk to your HubSpot account you need a Service Key (a private access token) from HubSpot.

In your HubSpot account, create a Service Key under Development → Keys → Service keys → Create, and give it these scopes:

• crm.objects.contacts.read
• crm.objects.contacts.write
• crm.schemas.contacts.read
• crm.schemas.contacts.write (optional)

The key looks like pat-…. Copy it.

Back in Powerlynx, open the Connection tab, paste the key into the Access token field, and click Save:

Powerlynx immediately checks the key against HubSpot:

• If the key is valid, the status switches to Connected and the token is stored securely (encrypted).
• If the key is missing a required scope, Powerlynx shows you exactly which scope to add in HubSpot.
• Any other problem shows the message returned by HubSpot, so you know what went wrong.

Use the eye button to reveal the stored key at any time, and Disconnect to remove it.

Mapping fields ​

The Field mapping tab is organised around HubSpot properties: you build a list of the HubSpot contact properties you want to fill, one row each. For every property you pick a Source and a Value:

• Mapped field — the property is filled from a Powerlynx customer field. Choose the field from the value dropdown — any built-in field plus the additional fields you've created.
• Static value — the property always receives the same fixed value you type, the same for every customer (for example, always sending Lead to a lifecycle-stage property, or a constant campaign source).

Static values let you populate HubSpot properties that have no Powerlynx equivalent at all. The HubSpot properties themselves are loaded live from your account. Use Add HubSpot contact property to add a row and the delete button to remove one; you can't target the same property twice.

Synchronizing & monitoring ​

The Synchronization tab is where you push customers and keep an eye on the result. At the top, a summary tells you how many customers will be created, how many will be updated, how many are already synced, and how many can't be synced (no email). Below that is a table listing every customer with their individual sync status.

Click Sync now to push your customers to HubSpot. A progress bar shows the run, and the table refreshes when it finishes. Customer names link straight to the customer page.

A single Sync now is all you need — it creates new contacts, updates the ones whose data has changed, and automatically retries any customer that failed last time.

What the statuses mean ​

• Synced — pushed to HubSpot and up to date.
• Needs update — already in HubSpot, but the customer's data has changed since the last sync. The next run will update the contact.
• Not synced — has an email and is ready to go, but hasn't been pushed yet. The next run will create the contact.
• Outdated — was synced successfully before, but the most recent attempt failed.
• Error — the last attempt failed and the contact was never created.
• Duplicate — another Powerlynx customer already owns this email address in HubSpot. To avoid overwriting the other contact, this customer is not pushed.
• No email — the customer has no email address, so they can't be turned into a HubSpot contact.