Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HubSpot Associations API

Operations for managing subscription associations

HubSpot Associations API is one of 93 APIs that HubSpot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 652 JSON Schema definitions.

Tagged areas include Associations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 652 JSON Schemas.

This API exposes 22 operations across 15 paths, and defines 16 schemas. It is described by OpenAPI 3.1.0, at version 3.0.0.

Requests are made against a single base URL, https://api.hubapi.com.

22 operations 15 paths 16 schemas 7 DELETE8 GET7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.0.0
Base URL
https://api.example.com
Authentication
OAuth 2.0
License
Resource Areas
1

Authentication & Security 1

HubSpot Associations API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 1 scope.

Paths & Operations 22

Across 15 paths, the API surfaces 22 operations — 7 DELETE, 8 GET, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Associations 22

Operations for managing subscription associations

GET
/crm/v3/objects/subscriptions/{subscriptionId}/associations/{toObjectType}
Hubspot List Subscription Associations
listSubscriptionAssociations 2 params → 200401404
GET
/crm/v3/objects/companies/{companyId}/associations/{toObjectType}
Hubspot List Company Associations
listCompanyAssociations 2 params → 200401404
PUT
/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Company Association
createCompanyAssociation 4 params → 200401404
DELETE
/crm/v3/objects/companies/{companyId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Company Association
deleteCompanyAssociation 4 params → 204401404
GET
/crm/v3/objects/contacts/{contactId}/associations/{toObjectType}
Hubspot List Contact Associations
listContactAssociations 2 params → 200401404
PUT
/crm/v3/objects/contacts/{contactId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Contact Association
createContactAssociation 4 params → 200401404
DELETE
/crm/v3/objects/contacts/{contactId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Contact Association
deleteContactAssociation 4 params → 204401404
GET
/crm/v3/objects/deals/{dealId}/associations/{toObjectType}
Hubspot List Deal Associations
listDealAssociations 2 params → 200401404
PUT
/crm/v3/objects/deals/{dealId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Deal Association
createDealAssociation 4 params → 200401404
DELETE
/crm/v3/objects/deals/{dealId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Deal Association
deleteDealAssociation 4 params → 204401404
GET
/crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}
Hubspot List Ticket Associations
listTicketAssociations 2 params → 200401404
PUT
/crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Ticket Association
createTicketAssociation 4 params → 200401404
DELETE
/crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Ticket Association
deleteTicketAssociation 4 params → 204401404
GET
/crm/v3/objects/emails/{emailId}/associations/{toObjectType}
Hubspot List Email Engagement Associations
listEmailEngagementAssociations 2 params → 200401404
PUT
/crm/v3/objects/emails/{emailId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create an Email Engagement Association
createEmailEngagementAssociation 4 params → 200401404
DELETE
/crm/v3/objects/emails/{emailId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete an Email Engagement Association
deleteEmailEngagementAssociation 4 params → 204401404
GET
/crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}
Hubspot List Meeting Associations
listMeetingAssociations 2 params → 200401404
PUT
/crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Meeting Association
createMeetingAssociation 4 params → 200401404
DELETE
/crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Meeting Association
deleteMeetingAssociation 4 params → 204401404
GET
/crm/v3/objects/tasks/{taskId}/associations/{toObjectType}
Hubspot List Task Associations
listTaskAssociations 2 params → 200401404
PUT
/crm/v3/objects/tasks/{taskId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Create a Task Association
createTaskAssociation 4 params → 200401404
DELETE
/crm/v3/objects/tasks/{taskId}/associations/{toObjectType}/{toObjectId}/{associationType}
Hubspot Delete a Task Association
deleteTaskAssociation 4 params → 204401404

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are Error (4 properties), CollectionResponseAssociation_2 (2 properties), CollectionResponseAssociation_3 (2 properties), Association_2 (2 properties). Each schema is shown below with its type and property counts.

Error
object
4 properties
Association_5
object
An association between two CRM objects.
2 properties
Paging_4
object
Pagination information.
1 property
Association_2
object
An association between two CRM objects.
2 properties
CollectionResponseAssociation_3
object
A list of associations.
2 properties
CollectionResponseAssociation_2
object
A list of associations.
2 properties
Paging_2
object
Pagination information.
1 property
Association
object
2 properties
Association_4
object
An association between two CRM objects.
2 properties
Paging
object
1 property
Paging_5
object
Pagination information.
1 property
CollectionResponseAssociation_4
object
A list of associations.
2 properties
Paging_3
object
Pagination information.
1 property
Association_3
object
An association between two CRM objects.
2 properties
CollectionResponseAssociation_5
object
A list of associations.
2 properties
CollectionResponseAssociation
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hubspot-associations-api-openapi.yml Raw ↑

Other APIs HubSpot publishes across the network.

HubSpot Posts API
HubSpot URL Redirects API
HubSpot Pipelines API
HubSpot Products API
HubSpot Line Items API
HubSpot Quotes API
HubSpot CRM Properties API
HubSpot Owners API
HubSpot CRM Imports API
HubSpot Custom Objects API
HubSpot Marketing Events API
HubSpot Forms API