HubSpot
Keep HubSpot up to date with every customer, deal and order, without copy and paste.
50 ways to read, 37 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with HubSpot, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Associate records in bulkApproval by rule
- Associate recordsApproval by rule
- List association labelsRead
Example flow
- Curacel Grow · Read claimsDone
- HubSpot · Upsert object record by unique propertyNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches HubSpot.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to HubSpot
- HubSpot's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a HubSpot test account before you go live.
For developers
Technical detail
HubSpot CRM records, orders, draft quotes, activities, marketing events, associations, lists and custom objects, with bulk upserts and reads, and invoices and payments for reconciliation.
HubSpot API docs- Source actions
- 50
- Destination actions
- 37
- Data types
- 34
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Association batches1
- Associate records in bulkDestinationProvider duplicate protectionApproval before production
Links up to 100 pairs of records with HubSpot's default association, for example orders to contacts.
Association labels1
- List association labelsSource
Association types between two object types (v4), with HubSpot-defined and custom labels.
Associations2
- Associate recordsDestinationProvider duplicate protectionApproval before production
Associates two records with the default association, or with a labelled association type when a type ID is supplied.
- List associationsSource
Records of one type associated with a record, with association labels (v4).
Calls3
- Create call logDestinationNot retried automaticallyApproval before production
Creates a HubSpot call log, optionally associated with other records.
- List callsSourceIncremental
HubSpot calls with typed default properties and any requested custom properties.
- Update call logDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot call log.
Carts1
- List cartsSourceIncremental
HubSpot carts with typed default properties and any requested custom properties.
Commerce payments1
- List paymentsSourceIncremental
HubSpot payments with typed default properties and any requested custom properties.
Companies6
- Create companyDestinationNot retried automaticallyApproval before production
Creates a HubSpot company, optionally associated with other records.
- Get companySource
Reads one HubSpot company by record ID, with typed properties and associated record IDs.
- List companiesSourceIncremental
HubSpot companies with typed default properties and any requested custom properties.
- Search companiesSource
Finds HubSpot companies with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update companyDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot company.
- Upsert CompaniesDestinationNexra idempotency keyApproval before production
Upsert operation for Companies.
Company records1
- List Company RecordsSource
List operation for Company Records.
Contacts5
- Create contactDestinationNot retried automaticallyApproval before production
Creates a HubSpot contact, optionally associated with other records.
- Get contactSource
Reads one HubSpot contact by record ID, with typed properties and associated record IDs.
- List contactsSourceIncremental
HubSpot contacts with typed default properties and any requested custom properties.
- Search contactsSource
Finds HubSpot contacts with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update contactDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot contact.
Customers2
- List CustomersSource
List operation for Customers.
- Upsert CustomersDestinationNexra idempotency keyApproval before production
Upsert operation for Customers.
Deal records1
- List Deal RecordsSource
List operation for Deal Records.
Deals5
- Create dealDestinationNot retried automaticallyApproval before production
Creates a HubSpot deal, optionally associated with other records.
- Get dealSource
Reads one HubSpot deal by record ID, with typed properties and associated record IDs.
- List dealsSourceIncremental
HubSpot deals with typed default properties and any requested custom properties.
- Search dealsSource
Finds HubSpot deals with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update dealDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot deal.
Emails3
- Create email logDestinationNot retried automaticallyApproval before production
Creates a HubSpot email log, optionally associated with other records.
- List logged emailsSourceIncremental
HubSpot logged emails with typed default properties and any requested custom properties.
- Update email logDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot email log.
Invoices1
- List invoicesSourceIncremental
HubSpot invoices with typed default properties and any requested custom properties.
Leads1
- List leadsSourceIncremental
HubSpot leads with typed default properties and any requested custom properties.
Line items4
- Create line itemDestinationNot retried automaticallyApproval before production
Creates a HubSpot line item, optionally associated with other records.
- Get line itemSource
Reads one HubSpot line item by record ID, with typed properties and associated record IDs.
- List line itemsSourceIncremental
HubSpot line items with typed default properties and any requested custom properties.
- Update line itemDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot line item.
List memberships1
- List list membersSource
Record IDs in a list, with the time each was added.
Lists2
- Get listSource
One list with its processing type, size and optionally its filter definition.
- Search listsSource
Lists (segments) by name and processing type, with member counts.
Marketing event attendance1
- Record event registration or attendanceDestinationProvider duplicate protectionApproval before production
Records that people registered for, attended or cancelled an event, by email. HubSpot creates contacts it does not know yet.
Marketing events3
- Create marketing eventDestinationNot retried automaticallyApproval before production
Adds an event run in another app (for example a Zoom webinar or an Eventbrite event) to HubSpot.
- List marketing eventsSource
Webinars, conferences and other events in HubSpot, with registration, attendance and cancellation counts.
- Create or update marketing eventDestinationProvider duplicate protectionApproval before production
Creates the event, or updates it when HubSpot already has an event with the same event ID from your app.
Meetings3
- Create meeting logDestinationNot retried automaticallyApproval before production
Creates a HubSpot meeting log, optionally associated with other records.
- List meetingsSourceIncremental
HubSpot meetings with typed default properties and any requested custom properties.
- Update meeting logDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot meeting log.
Notes3
- Create noteDestinationNot retried automaticallyApproval before production
Creates a HubSpot note, optionally associated with other records.
- List notesSourceIncremental
HubSpot notes with typed default properties and any requested custom properties.
- Update noteDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot note.
Object batches2
- Read records in bulkSource
Reads up to 100 records of one object type by record ID or by a unique property value, for example to check what a load wrote.
- Upsert records in bulkDestinationProvider duplicate protectionApproval before production
Creates or updates up to 100 records of one object type in one call, matched on a unique property such as an external ID. Use it to load warehouse or store records into HubSpot.
Objects6
- Create object recordDestinationNot retried automaticallyApproval before production
Creates a record of any object type, including custom objects.
- Get object recordSource
Reads one record by ID or by a unique property value.
- List object recordsSourceIncremental
Records of any object type, including custom objects, with requested properties.
- Search object recordsSource
Finds records of any object type, including custom objects, with validated filters in the CRM search request body.
- Update object recordDestinationProvider duplicate protectionApproval before production
Updates properties on a record by ID or unique property value.
- Upsert object record by unique propertyDestinationProvider duplicate protectionApproval before production
Creates or updates a record matched on a unique property (batch upsert endpoint with one input).
Orders3
- Create orderDestinationNot retried automaticallyApproval before production
Creates a HubSpot order, optionally associated with other records.
- List ordersSourceIncremental
HubSpot orders with typed default properties and any requested custom properties.
- Update orderDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot order.
Owners2
- Get ownerSource
One owner by owner ID, with team membership.
- List ownersSource
Users who can own CRM records, with team membership.
Pipelines2
- Get pipelineSource
One pipeline with ordered stages for deals, tickets or a custom object.
- List pipelines and stagesSource
Pipelines with ordered stages, probabilities and closed flags for deals, tickets or custom objects.
Products5
- Create productDestinationNot retried automaticallyApproval before production
Creates a HubSpot product, optionally associated with other records.
- Get productSource
Reads one HubSpot product by record ID, with typed properties and associated record IDs.
- List productsSourceIncremental
HubSpot products with typed default properties and any requested custom properties.
- Search productsSource
Finds HubSpot products with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update productDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot product.
Properties1
- List propertiesSource
Property definitions of an object type: types, field types, options, groups and unique flags.
Quotes5
- Create draft quoteDestinationNot retried automaticallyApproval before production
Creates a HubSpot draft quote, optionally associated with other records.
- Get quoteSource
Reads one HubSpot quote by record ID, with typed properties and associated record IDs.
- List quotesSourceIncremental
HubSpot quotes with typed default properties and any requested custom properties.
- Search quotesSource
Finds HubSpot quotes with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update draft quoteDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot draft quote.
Schemas1
- List custom object schemasSource
Custom object definitions with object type IDs, labels, display and required properties.
Subscriptions1
- List subscriptionsSourceIncremental
HubSpot subscriptions with typed default properties and any requested custom properties.
Tasks3
- Create taskDestinationNot retried automaticallyApproval before production
Creates a HubSpot task, optionally associated with other records.
- List tasksSourceIncremental
HubSpot tasks with typed default properties and any requested custom properties.
- Update taskDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot task.
Tickets5
- Create ticketDestinationNot retried automaticallyApproval before production
Creates a HubSpot ticket, optionally associated with other records.
- Get ticketSource
Reads one HubSpot ticket by record ID, with typed properties and associated record IDs.
- List ticketsSourceIncremental
HubSpot tickets with typed default properties and any requested custom properties.
- Search ticketsSource
Finds HubSpot tickets with validated property filters, a text query and one sort, sent in the CRM search request body.
- Update ticketDestinationProvider duplicate protectionApproval before production
Updates supplied properties on a HubSpot ticket.
Access and limits
- Authentication
- Private app access token (same credential as the built-in HubSpot connection)
- Plans and access
- All HubSpot accounts; custom objects and some objects (quotes, line items) depend on Hub tier. The private app or OAuth token must hold the CRM object read/write scopes for each object used.
- Test environment
- Developer test accounts and standard sandboxes use the same CRM API.
- Rate limits
- Private apps: 100 requests per 10 seconds (Free/Starter) or 190 (Professional/Enterprise) plus a daily account limit; CRM search is limited to 5 requests per second. HTTP 429.
- Pagination
- paging.next.after cursors; list endpoints return up to 100 records per page, search up to 200 (10,000 per query), associations up to 500 and list memberships up to 250. Lists search pages by offset.
- Provider events
- Webhook subscriptions for CRM object creation, property change and association events. Flows can start the moment something happens: when a new contact is created; when a new deal is created; when a contact property changes.
Before you build a flow
- Company and deal reads require their object read scopes. Company upsert matches exact primary domain, rejects ambiguous matches and verifies saved name/domain. Company read/write scopes are required. Search indexing delays and concurrent creates require reconciliation. Deals are read-only; associations, custom fields and pipeline conversion are not implemented.
- Contact reads and email-keyed upsert with read-back verification of identity, email and names. Contact read and write scopes are required for destinations. Marketing consent is not changed.
- Uses the CRM v3 object API and v4 associations API, which HubSpot now lists under legacy versions alongside date-versioned APIs; both remain supported.
- Incremental reads use CRM search, which caps each query at 10,000 results; narrow updatedSince windows for large backfills.
- Creates have no idempotency key; uncertain creates are not repeated automatically. Use objects.upsert with a unique property for repeat-safe writes.
- Quotes are written as drafts only (hs_status DRAFT); publishing, approval, e-signature and payment properties are refused. Publish quotes in HubSpot.
- Calls, meetings and emails are logged on the CRM timeline only; nothing is dialled, sent or invited.
- Search operations send filters, the text query and sort in the POST /crm/v3/objects/{type}/search body. Filters are validated: at most 5 groups, 6 filters per group and 18 in total, with HubSpot's documented operators.
- Lists are read-only; list size comes from the hs_list_size additional property and is null when HubSpot omits it.
- Bulk upserts, bulk reads and bulk associations take up to 100 records per call; bulk upserts match on one unique property and refuse a value listed twice.
- Invoices, payments, carts, subscriptions and leads are read-only (HubSpot creates invoices and payments through its own commerce tools). Orders can be created and updated; nothing is charged.
- Commerce objects, leads and marketing events need their own scopes and depend on the HubSpot account's tier; HubSpot drops optional scopes the account cannot grant.
- Marketing events record events run in other apps and who registered, attended or cancelled; HubSpot creates contacts for unknown emails but sends nothing.
- Intentionally excluded: deletes and archives, merges, GDPR delete, marketing emails, single-send and transactional email, sequence and workflow enrolment, list membership changes, quote publishing and payments.
Developer reference
- Create the HubSpot credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose HubSpot, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/hubspot and the Connections API.