Genesys Cloud CX × HubSpot
How every voice, chat, messaging and email conversation handled in Genesys Cloud CX can land on the right HubSpot contact, and how HubSpot data can steer routing and show agents who is on the line.
Does Genesys Cloud integrate with HubSpot?
Genesys Cloud CX runs the contact center: routing, queues, agents and every customer conversation across voice and digital channels. HubSpot holds the customer record, the pipeline and the service history. This assessment shows how to connect the two.
Public documentation. The client's own admin issues credentials, with no vendor approval needed.
Open API. The Platform API is documented publicly. The client's admin creates an OAuth client with the minimum roles.
Based on the vendor's public documentation. Access terms are confirmed with the vendor and the client in discovery.
Genesys Cloud exposes conversations, wrap-ups and routing through documented APIs, so every conversation can live on the HubSpot record it belongs to.
Campaign Creators assessment
Genesys Cloud offers a REST Platform API with OAuth client credentials for server integrations, real-time conversation events through its Notification Service (WebSockets) or its Amazon EventBridge integration, an Analytics API for conversation detail and history, and Data Actions that let Architect flows and agent Scripts call outside REST APIs. That makes a direct Genesys-to-HubSpot integration buildable in both directions: conversations flow into HubSpot as calls and timeline events, and HubSpot data flows back to route the call and brief the agent. The main decision is where agents work, in the Genesys Cloud desktop or inside HubSpot.
Ratings are CC judgments from Genesys public documentation. Licensing, enabled channels and limits for the client's organization are confirmed during discovery.
Events and history, both documented
Real-time conversation events keep HubSpot current within seconds, and the Analytics API's conversation detail query fills gaps and loads history, so the two always reconcile.
Phone numbers are the match key
Most callers are identified by phone number. Numbers are normalized to E.164 on both sides, and shared or unknown numbers follow agreed rules before anything is written.
Agent desktop and recording policy first
The client decides whether agents work in Genesys Cloud or in HubSpot, and what recording and transcript data HubSpot may hold, before the build starts.
Which Genesys Cloud APIs does the integration use?
Seven Genesys Cloud capabilities matter to a HubSpot build. Four carry the integration, one enriches it, one is handled with care, and one is a scope decision.
Platform API
REST · /api/v2The REST API behind Genesys Cloud. The integration reads conversations, participants, queues, users and wrap-up codes from it.
/api/v2/conversationsfor conversation and participant detail/api/v2/routing/queuesand/api/v2/routing/wrapupcodes/api/v2/usersto match agents to HubSpot owners
Notification Service & EventBridge
WebSocket topics · Amazon EventBridgeReal-time events for conversation start, agent connect, wrap-up and end. CC uses EventBridge where the client has an AWS account, or Notification Service channels otherwise.
- Conversation detail events, delivered as JSON
- EventBridge routes events into the client's AWS account
- Notification channels are limited per client; confirm counts
Analytics API
Conversation detail query and jobsCompleted conversations with participants, sessions, segments, queue, wrap-up code and handle time. Used for backfill and nightly reconciliation.
POST /api/v2/analytics/conversations/details/query- Asynchronous jobs for large date ranges
- Fills any gap left by a missed event
Data Actions
Web services data actionsArchitect flows and agent Scripts call outside JSON APIs. CC configures data actions that call HubSpot directly.
- Look up the HubSpot contact by phone or email
- Route by owner, lifecycle stage or open ticket
- Create a HubSpot ticket from a flow
Scripts & screen pop
Agent scripts · web page componentScripts guide agents through each interaction and can show a web page or pop a CRM record, using data a data action returned.
- Show HubSpot name, owner and open tickets
- Open the HubSpot record in one click
- Inbound flows can select which script the agent sees
Recordings & transcripts
Recording API · Speech and Text AnalyticsAudio and transcripts stay in Genesys Cloud under its retention and access controls. HubSpot receives a link and, where approved, a short summary.
- No audio files stored in HubSpot
- Transcript access needs the right Genesys licence and roles
- Compliance approves what HubSpot may show
Where agents work
Scope decisionAgents can stay in the Genesys Cloud desktop with HubSpot data popped in, or work inside HubSpot through a CC-built calling app on HubSpot's Calling Extensions SDK.
- Genesys desktop: fastest to deliver, no change for agents
- HubSpot calling app: agents call from the CRM record
- The calling app is proven in a short proof of concept first
How does the Genesys Cloud HubSpot integration work?
Genesys Cloud pushes conversation events to a CC-hosted integration layer, which matches the customer, waits for wrap-up, and writes one complete record to HubSpot. In the other direction, Genesys data actions call HubSpot during the conversation to route it and brief the agent.
HubSpot is the customer record
Every caller is one HubSpot contact. Genesys Cloud keeps its own routing data, and the integration links the two by phone, email and HubSpot ID.
One record per conversation
Transfers and consults are merged in the integration layer, so a conversation appears once on the timeline with every agent and wrap-up on it.
Sensitive media stays put
Recordings and transcripts remain in Genesys Cloud. HubSpot stores links and approved summaries only.
What does Genesys Cloud HubSpot integration setup involve?
Each phase ends on a gate the client signs off before the next begins, so the fixed scope holds even if channels, licences or event payloads differ from the public docs.
Discovery & access
Confirm the Genesys Cloud region, licensed channels, and whether EventBridge or the Notification Service carries events. Create an OAuth client with client credentials and the minimum roles and divisions.
Agent desktop & data policy
Decide where agents work, which wrap-up codes need follow-up, and what recording and transcript data HubSpot may show.
Identity & conversation rules
Agree phone normalization, the match order (HubSpot ID, then phone, then email), rules for unknown callers, and how transfers become one record.
HubSpot data model
Create call properties, contact rollups, custom events for digital channels, dispositions mapped to wrap-up codes, and the follow-up ticket pipeline in a HubSpot sandbox.
Build
Build event intake, the conversation assembler, the HubSpot writer, the lookup service and the Genesys data actions. Wire a Script to show HubSpot context.
Backfill & reconciliation
Load an agreed history window through the Analytics API, then run a nightly detail query that repairs any missed event.
Pilot queue & launch
Go live on one queue with automations paused, run in parallel for two weeks, then extend to all queues and switch on workflows.
What does the Genesys Cloud HubSpot integration sync?
Field names follow Genesys Cloud's conversation and analytics models as documented. Exact paths for each channel are confirmed from real payloads during discovery.
| Genesys Cloud field | HubSpot property | Object | Direction | Notes |
|---|---|---|---|---|
| Voice conversations → HubSpot calls | ||||
| conversationId | gc_conversation_id | Call | GC → HS | Unique key. Makes every write idempotent. |
| originatingDirection | hs_call_direction | Call | GC → HS | Inbound or outbound. |
| conversationStart | hs_timestamp | Call | GC → HS | |
| Customer phone (ANI / DNIS) | hs_call_from_number, hs_call_to_number | Call | GC → HS | Normalized to E.164. |
| Handle time (talk + hold + after-call work) | hs_call_duration, gc_handle_time_sec | Call | GC → HS | HubSpot duration in milliseconds. |
| wrapUpCode | hs_call_disposition, gc_wrapup_code | Call | GC → HS | Wrap-up codes mapped to HubSpot call outcomes. |
| Wrap-up notes | hs_call_body | Call | GC → HS | Agent notes as entered. |
| Agent userId | hubspot_owner_id | Call | GC → HS | Matched to a HubSpot user by email. |
| queueId | gc_queue_name | Call | GC → HS | Queue name looked up from routing. |
| Interaction link | gc_interaction_link | Call | GC → HS | Opens the conversation in Genesys Cloud; audio stays there. |
| Digital conversations → timeline events | ||||
| mediaType chat / message | Custom event: Contact center conversation | Contact | GC → HS | Channel, queue, agent and wrap-up as event properties. |
| mediaType email | Custom event: Contact center conversation | Contact | GC → HS | Subject and wrap-up only; message bodies stay in Genesys. |
| Messaging channel type | gc_last_channel | Contact | GC → HS | Confirm which messaging channels are enabled. |
| Transcript link | Event property: transcript link | Contact | GC → HS | Only where the data policy allows it. |
| Caller identity | ||||
| Customer phone | phone, mobilephone | Contact | GC → HS | Match key. Shared numbers go to a review list. |
| Customer email address | Contact | GC → HS | Match key for email and web chat. | |
| Unknown caller | New contact | Contact | GC → HS | Optional; off by default. |
| HubSpot contact lookup | Data action response | Contact | HS → GC | Name, owner, lifecycle stage and open tickets returned to Genesys. |
| Routing, service & follow-up | ||||
| HubSpot owner or tier | Data action → Architect routing | Contact | HS → GC | Route to the owner or a priority queue. |
| Wrap-up codes that need follow-up | Ticket | Ticket | GC → HS | Ticket created with the call associated. |
| Abandoned or missed call | Task | Task | GC → HS | Assigned to the contact owner. |
| Wrap-up code list | Call outcome options | Call | GC → HS | Kept in step when codes change. |
| Contact rollups | ||||
| max(conversationEnd) | gc_last_conversation_date | Contact | GC → HS | Computed in the integration layer. |
| count(conversations, 90 days) | gc_conversations_90d | Contact | GC → HS | Computed in the integration layer. |
| Latest wrapUpCode | gc_last_wrapup_code | Contact | GC → HS | |
| Abandoned conversations, 90 days | gc_abandoned_90d | Contact | GC → HS | Conversations where no agent connected. |
How are authentication and API limits handled?
Genesys Cloud uses OAuth clients created by an organization admin; HubSpot uses one app token. Values Genesys does not publish are marked for confirmation.
| Topic | Genesys Cloud | HubSpot |
|---|---|---|
| Authentication | OAuth client credentials grant for server integrations. The client is given the minimum roles, each tied to the right divisions. Token lifetime is set between 300 and 172,800 seconds. | Private app access token or OAuth 2.0 public app, scoped per object. |
| Region | Each Genesys Cloud organization lives in one region with its own API and login domains. Confirm the region in discovery. | One API domain for all portals. |
| Real-time events | Amazon EventBridge integration (needs the client's AWS account) or Notification Service WebSocket channels. Channels and topics per client are limited; confirm current values. | HubSpot writes are immediate; batch endpoints handle volume. |
| History & reconciliation | Analytics conversation detail query for recent windows; asynchronous detail jobs for large ranges. | CRM search and batch APIs; imports for large loads. |
| Calls into HubSpot | Web services data actions store HubSpot credentials and map request and response JSON. Architect flows and Scripts call them during the conversation. | CRM search by phone or email; the lookup service caches answers so flows stay fast. |
| Rate limits | Published per OAuth client and per organization in the Genesys Developer Center. Confirm values for the client's organization. | Per-10-second burst and daily limits by subscription tier. |
| Sensitive data | Recordings and transcripts are governed by Genesys roles and retention. HIPAA-enabled organizations add a 15-minute idle timeout to tokens. | Sensitive data properties available on Enterprise; field-level permissions by team. |
What should you plan for, and what does the integration unlock?
Severity reflects impact on the SOW, not technical difficulty alone.
Challenges to plan for
A HubSpot calling app changes the agent experience and needs a proof of concept; staying in the Genesys desktop with a screen pop is faster. The choice changes the scope, so it is made first.
Callers can withhold numbers, share a main line, or appear on several contacts. Numbers are normalized to E.164, and anything ambiguous goes to a review list instead of the wrong record.
Calls can contain payment or health details. The data policy decides what HubSpot shows, and audio never leaves Genesys Cloud.
One customer conversation can pass through several agents and queues. The integration waits for the last wrap-up and writes one call with every segment on it.
A dropped WebSocket channel or paused event bus can miss events. A nightly Analytics query compares counts and repairs gaps.
High-volume centers create many writes. The integration batches writes and skips IVR-only conversations unless the client wants them.
Opportunities in HubSpot
Sales, service and marketing see each call, chat and message on the contact timeline, with outcome and notes.
A script pops the HubSpot record with owner, lifecycle stage and open tickets before the agent says hello.
Key accounts route to their owner or a priority queue based on HubSpot data at the moment the call arrives.
Selected wrap-up codes open tickets or tasks and start HubSpot workflows, so nothing waits on a manual handoff.
Conversation volume, outcomes and handle time sit beside pipeline and service data in HubSpot dashboards.
Abandoned calls from open deals create a task for the owner within minutes.
One conversation, end to end.
The integration follows the customer from the first ring to the follow-up, with HubSpot holding the record at every step.
- The customer calls or starts a chat. A data action looks up the HubSpot contact and the flow routes on owner or tier.
- The agent's script shows the HubSpot record, so the conversation starts with context.
- At wrap-up, the integration writes one call or event to HubSpot with outcome, notes, queue and agent.
- Wrap-up codes that need follow-up open a ticket or task, and HubSpot workflows take it from there.
Which HubSpot properties does the integration create?
All custom properties use the gc_ prefix in a Genesys Cloud property group. Rollups are calculated in the integration layer so every report agrees.
| Internal name | Label | Object | Type | Source / logic |
|---|---|---|---|---|
| gc_conversation_id | Genesys Conversation ID | Call | Single-line text | conversationId; unique |
| gc_queue_name | Queue | Call | Dropdown | Queue name from queueId |
| gc_wrapup_code | Wrap-up Code | Call | Dropdown | wrapUpCode name |
| gc_handle_time_sec | Handle Time (sec) | Call | Number | Talk, hold and after-call work |
| gc_interaction_link | Genesys Interaction Link | Call | Single-line text | Link to the conversation in Genesys Cloud |
| gc_last_conversation_date | Last Contact Center Conversation | Contact | Date | Latest conversation end |
| gc_last_channel | Last Channel | Contact | Dropdown | Voice, chat, messaging, email |
| gc_last_wrapup_code | Last Wrap-up Code | Contact | Dropdown | Latest wrap-up |
| gc_conversations_90d | Conversations (90 days) | Contact | Number | Computed in integration layer |
| gc_abandoned_90d | Abandoned (90 days) | Contact | Number | No agent connected |
| gc_conversation_ref | Genesys Conversation ID | Ticket | Single-line text | Conversation that opened the ticket |
Interactive scope builder
Choose the channels and fields for this engagement and the direction each one syncs. Required fields are the keys the integration cannot run without. Copy the summary into the SOW or a reply to the client.
Scope summary
Sources & verification
Based on public documentation. Each item marked for confirmation is verified with the client's Genesys Cloud administrator during discovery.
- Genesys Cloud: Create an OAuth client
- Genesys Cloud Developer Center: Notification Service
- Genesys Cloud: About the Amazon EventBridge integration
- Genesys Cloud: About the data actions integrations
- Genesys Cloud: About scripting
- Genesys Cloud Developer Center: API rate limits
- Genesys Cloud Developer Center: Speech and Text Analytics APIs
- HubSpot Developers: Calling Extensions SDK
Genesys Cloud HubSpot integration FAQ
Does Genesys Cloud integrate with HubSpot?
Yes, and access is open: Genesys Cloud publishes its Platform API documentation, and the client's own administrator creates an OAuth client with the minimum roles, with no vendor approval needed. Campaign Creators builds a custom integration layer on the Platform API, the Notification Service or Amazon EventBridge for real-time conversation events, the Analytics API for history, and Data Actions for routing and screen pops.
What data syncs between Genesys Cloud and HubSpot?
Voice conversations sync into HubSpot as calls on the contact timeline, with conversation ID, direction, duration, wrap-up code and agent. Chat, messaging and email conversations sync as custom timeline events, wrap-ups needing follow-up become HubSpot tickets or tasks, and contact rollups compute the latest conversation date and a 90-day count. HubSpot contact, owner, lifecycle stage and open tickets flow back to Genesys Data Actions so Architect flows and agent Scripts can route the call and brief the agent.
Which system owns which data?
Genesys Cloud owns contact center operations: routing, queues, recordings and transcripts stay there under Genesys retention and access controls, and HubSpot never stores or plays audio. HubSpot owns the customer record: the matched contact, the call and conversation timeline, pipeline and service history, holding only a link and an approved summary for sensitive media.
What does setting up the Genesys Cloud HubSpot integration involve?
Seven phases, each closed by a client sign-off: discovery and OAuth client setup, an agent-desktop and recording/transcript data-policy decision, identity and conversation merge rules for matching callers by phone, email and HubSpot ID, the HubSpot data model with call properties, contact rollups and a follow-up ticket pipeline built in a sandbox, the build itself, a backfill and reconciliation pass through the Analytics API, and a two-week parallel pilot on one queue before all queues go live.
How long does the integration take and what does it cost?
Timeline and cost depend on which channels are licensed and enabled, whether agents stay in the Genesys Cloud desktop or move into a HubSpot calling app, and the recording and transcript data policy compliance requires. Campaign Creators confirms these in discovery and provides a fixed scope before the build starts.
Ready to Get More From HubSpot?
Whether you’re implementing HubSpot, optimizing what you already have, connecting systems, or scaling your customer experience, we’ll help you figure out the right next step.
.png?width=1920&height=553&name=cc-logo-color%20(2024).png)