Connect Plenum to HubSpot
This guide walks you through connecting your HubSpot portal to Plenum, explains which permissions are granted, and shows you how to disconnect at any time.
Last updated: 2026-06-28
Overview
Plenum is built natively for HubSpot: it runs directly on your HubSpot portal and reads and writes only your own HubSpot data. Plenum accesses only the areas you explicitly authorise. Your data never leaves HubSpot and is neither stored nor used by by Nu for its own purposes. All processing takes place on Infomaniak servers in Switzerland.
Before you start
- An active HubSpot account (any plan works; Marketing Events is included on every HubSpot plan).
- A HubSpot user with admin rights or permission to install apps and manage integrations.
- An active Plenum plan.
Connect HubSpot (OAuth)
The connection is established via HubSpot's secure OAuth flow. Follow these steps:
- Go to app.bynu.ch/signup and choose a Plenum plan.
- Click "Connect HubSpot".
- You will be redirected to the HubSpot consent screen. Review the requested permissions carefully.
- Click "Connect" or "Grant access" to confirm.
- You are returned to Plenum. Your portal is now linked.
Scopes Plenum requests and why
| Scope | What it lets Plenum do | Why it's needed |
|---|---|---|
| oauth | Establishes the secure OAuth connection to your portal. | Required to connect at all. |
| crm.objects.contacts.read | Read your contacts. | Import people as attendees and match them against existing contacts. |
| crm.objects.contacts.write | Update contacts. | Write registration and check-in status back to contacts and set the contact properties Plenum uses (for example QR-code and cancellation links). |
| crm.objects.companies.read | Read companies. | Group attendees by company and enable VIP handling. |
| crm.objects.companies.write | Update companies. | Enables optional company-level fields that Plenum may need. |
| crm.lists.read | Read your lists. | Import attendees from an existing HubSpot list. |
| crm.lists.write | Manage lists. | Keep a static list per attendance status in HubSpot. |
| crm.schemas.contacts.read | Read the contact property schema. | Detect which properties already exist in your portal. |
| crm.schemas.contacts.write | Create contact properties. | Create the Plenum properties in your portal on first connect. |
| crm.objects.marketing_events.read | Read marketing events. | Read your existing events and attendance records. |
| crm.objects.marketing_events.write | Write marketing events. | Create and sync the event in HubSpot and write attendance status (registered, attended, cancelled). |
What Plenum sets up on first connect
On the first connection, Plenum checks which of its required contact properties do not yet exist in your HubSpot portal and creates them automatically. It can also create a Marketing Event in HubSpot. No existing data is modified or deleted.
Verify the connection
After connecting, Plenum settings will show your HubSpot portal ID and a green healthy status. We recommend these quick checks:
- Create a test event in Plenum and confirm it appears in HubSpot under Marketing Events.
- Add a test contact and verify that the registration status and contact properties are written correctly in HubSpot.
Disconnect / uninstall
You can disconnect at any time, either inside Plenum settings or directly in HubSpot under Settings > Integrations > Connected Apps by removing Plenum.
For details on data retention, please refer to our privacy policy.
Troubleshooting
- Missing permissions: Reconnect Plenum using a HubSpot account with admin or app-install rights.
- A scope was declined: The related feature will not work. Disconnect, reconnect, and grant all requested permissions.
- Portal shows as disconnected: Manually disconnect and reconnect.
- Still stuck: Contact our support team at /support.
Need help?
Our support team is available at bynu.ch/support. For privacy-related information, see our privacy policy.