Hubspot

Configuration

HubSpot source connector integrates with the HubSpot CRM API to extract CRM data.

Synchronizes customer relationship management data.

It provides comprehensive access to contacts, companies, deals, and support tickets.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo UI or API using the OAuth flow.

Supported authentication methods:

• OAuth Browser Flow (recommended for UI)

• OAuth Token (for programmatic access)

• Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

HubspotContactEntity

Schema for HubSpot contact entities with flexible property handling.

Reference: https://developers.hubspot.com/docs/api/crm/contacts

Field	Type	Description
contact_id	str	The HubSpot contact ID.
display_name	str	Display name derived from first/last name or email.
created_time	datetime	When the contact was created.
updated_time	datetime	When the contact was last updated.
first_name	Optional[str]	The contact's first name
last_name	Optional[str]	The contact's last name
email	Optional[str]	The contact's email address
properties	Dict[str, Any]	All properties from HubSpot contact object
archived	bool	Whether the contact is archived
web_url_value	Optional[str]	URL to view this contact in HubSpot.

HubspotCompanyEntity

Schema for HubSpot company entities with flexible property handling.

Reference: https://developers.hubspot.com/docs/api/crm/companies

Field	Type	Description
company_id	str	The HubSpot company ID.
company_name	str	Display name of the company.
created_time	datetime	When the company was created.
updated_time	datetime	When the company was last updated.
domain	Optional[str]	The company's domain name
properties	Dict[str, Any]	All properties from HubSpot company object
archived	bool	Whether the company is archived
web_url_value	Optional[str]	URL to view this company in HubSpot.

HubspotDealEntity

Schema for HubSpot deal entities with flexible property handling.

Reference: https://developers.hubspot.com/docs/api/crm/deals

Field	Type	Description
deal_id	str	The HubSpot deal ID.
deal_name	str	The name of the deal.
created_time	datetime	When the deal was created.
updated_time	datetime	When the deal was last updated.
amount	Optional[float]	The monetary value of the deal
properties	Dict[str, Any]	All properties from HubSpot deal object
archived	bool	Whether the deal is archived
web_url_value	Optional[str]	URL to view this deal in HubSpot.

HubspotTicketEntity

Schema for HubSpot ticket entities with flexible property handling.

Reference: https://developers.hubspot.com/docs/api/crm/tickets

Field	Type	Description
ticket_id	str	The HubSpot ticket ID.
ticket_name	str	Display name for the ticket.
created_time	datetime	When the ticket was created.
updated_time	datetime	When the ticket was last updated.
subject	Optional[str]	The subject of the support ticket
content	Optional[str]	The content or description of the ticket
properties	Dict[str, Any]	All properties from HubSpot ticket object
archived	bool	Whether the ticket is archived
web_url_value	Optional[str]	URL to view this ticket in HubSpot.