- Prosyo Docs
- Integrations
- HubSpot
On this page
Send Prosyo prospects to HubSpot as contacts. Stages, first-touch lines and custom fields come along, using a field map you choose.
What syncs#
- New prospects become HubSpot contacts, matched by email.
- Stage changes update the contact's lifecycle stage.
- Enrichment and first-touch lines update the contact.
- Replies update the contact.
Prospects without an email are skipped. HubSpot matches on email, and Prosyo never invents one.
1. Create a HubSpot private app#
You need to be a Super Admin in HubSpot.
- In HubSpot, click the settings gear.
- Go to Integrations → Private Apps. In newer HubSpot accounts this is Development → Legacy apps → Create legacy app → Private.
- Click Create a private app and name it Prosyo.
- Open the Scopes tab and turn on:
crm.objects.contacts.readcrm.objects.contacts.writecrm.schemas.contacts.read
- Click Create app, then Continue creating.
- Copy the access token. It starts with
pat-.
2. Connect in Prosyo#
- Go to Integrations → HubSpot.
- Paste the token into Private app access token.
- Click Connect. Prosyo stores the token encrypted and never shows it again.
3. Map fields#
Under Field mapping, match each Prosyo field to a HubSpot property. The default map is:
| Prosyo field | HubSpot property |
|---|---|
email | |
| First name | firstname |
| Last name | lastname |
| Title | jobtitle |
| Phone | phone |
| Company name | company |
| Website | website |
| Pipeline stage | lifecyclestage |
| First-touch line | message |
You can also map LinkedIn URL, Company domain, Source, Last replied at and any of your custom fields.
Click Save mapping.
Stage → lifecycle stage#
| Prosyo stage | HubSpot lifecycle stage |
|---|---|
| New | Subscriber |
| Contacted | Lead |
| Replied | Marketing qualified lead |
| Interested | Sales qualified lead |
| Meeting | Opportunity |
| Customer | Customer |
| Not interested | Other |
HubSpot doesn't let a lifecycle stage move backwards by default. If you'd rather keep lifecycle stage under HubSpot's control, map Pipeline stage to Lead status (hs_lead_status) or to a custom property instead.
4. Choose events#
Under Events, pick when Prosyo writes to HubSpot. The defaults are:
- Prospect created
- Stage changed
- Prospect enriched
- Reply received
5. Test#
Click Test connection to send a sample without changing live contacts. Recent deliveries shows every sync and any error.
Troubleshooting#
| Problem | Fix |
|---|---|
| 401 / unauthorized | The token was deleted or rotated in HubSpot. Paste a new one. |
| 403 / missing scopes | Add the three scopes above to the private app, then paste the new token. |
| Contact not created | The prospect has no email. |
| Property not in the list | Check that the property exists on Contacts in HubSpot, then reopen the mapping. |
Disconnect#
Click Disconnect on Integrations → HubSpot. To fully revoke access, also delete the private app in HubSpot.
