Connecting HubSpot

OAuth Flow

Conduits connects to HubSpot via OAuth 2.0. From Settings in the dashboard, click Connect HubSpot. You'll be redirected to HubSpot where you authorize Conduits to access your portal.

After authorization, HubSpot redirects back to Conduits with an authorization code. Conduits exchanges this for access and refresh tokens, which are encrypted and stored securely.

Scopes We Request

Scope	Why
crm.objects.contacts.read	Search and read contacts to match with Telegram users
crm.objects.contacts.write	Update contacts with Telegram metadata
crm.schemas.contacts.read	Read contact property definitions
crm.schemas.contacts.write	Create custom contact properties for Telegram data
crm.objects.companies.read	Associate notes with companies
crm.objects.deals.read	Context for deal signal detection
timeline	Create timeline events and notes
oauth	Token management

Conduits does not request write access to deals, tickets, or any other CRM objects beyond contacts and notes.

Custom Properties

On first connection, Conduits creates four custom properties on your HubSpot contacts:

Property	Type	Purpose
telegram_username	Text	The contact's Telegram username
telegram_user_id	Number	Telegram's numeric user ID
telegram_last_sync	DateTime	When this contact was last synced
telegram_conversation_count	Number	Total digests synced for this contact

These properties appear under Contact Information and can be used in HubSpot filters, lists, and workflows.

HubSpot Tier Compatibility

Conduits works with any HubSpot tier, including Free. Conduits creates rich HTML notes on contact timelines using the Notes API, which is available on all plans.

Disconnecting

To revoke Conduits's access to your HubSpot portal:

1. Go to HubSpot Settings > Integrations > Connected Apps
2. Find Conduits and click Uninstall

This revokes Conduits's access tokens. Previously created notes and custom properties remain in HubSpot.