Connect HubSpot to Elido

The HubSpot integration writes link clicks into HubSpot as custom timeline events. When someone clicks a tracked link and Elido can tie the click to an email address, the event appears on that contact's record in HubSpot.

Connect via OAuth

1. In Elido, open Dashboard → Integrations → HubSpot and start the connection.
2. The HubSpot OAuth screen opens. Sign in with an account that is allowed to install apps in your portal.
3. HubSpot shows the requested scopes: contacts read and write, timeline events and automation. Elido searches for contacts by email and writes timeline events to them.
4. Approve the app. HubSpot redirects you back to Elido.

Refresh tokens are renewed automatically. If you revoke access from HubSpot's side (Settings → Connected Apps), Elido can no longer write events until you reconnect.

How a click is matched to a contact

Elido looks for an email address in this order and uses the first valid one:

1. An email value passed with the click event.
2. metadata.email on the click event.
3. utm_content, if it contains an email address.
4. An email= query parameter on the destination URL (a common pattern in transactional emails).

Then it searches your HubSpot contacts for that email. If no contact matches, nothing is written.

What Elido writes to HubSpot

For each matched click, one timeline event is created on the contact with these tokens:

• short_url and destination_url
• campaign (from utm_campaign) and source (from utm_source)
• occurred_at

HubSpot shows it as a custom timeline event on the contact record. Elido does not change contact properties or deals.

What doesn't sync

• Clicks without an email — if Elido cannot identify an email, the click is skipped.
• Conversions — conversion events are not sent to HubSpot yet (see the Planned note above).
• Historical data — the integration is forward-only from the moment you connect.
• HubSpot → Elido — outbound only. HubSpot changes don't flow back to Elido.

Troubleshooting

Clicks don't show on the contact — Check that the email reaches Elido through one of the four routes above and that a HubSpot contact with that exact email exists (matching is case-insensitive).

Events stopped after revoking the app — Reconnect from Dashboard → Integrations → HubSpot.

Empty campaign or source in the event — Elido takes them from the click's UTM parameters. If the link has no UTMs, those tokens are empty.