Hubspot API Integration Vol.2
These are the list of integration use cases supported by Knit for Hubspot API as part of the CRM category
Create a Product
ID
: post_create_a_productOperation
: writeEntities
: property, association, productSummary
: This API endpoint allows you to create a product with specified properties and associations in the HubSpot CRM. The request requires authentication via a Bearer token and must include the product properties such as name, price, and SKU in the request body. The response returns the created product's details, including its ID, creation timestamp, and properties. The API adheres to standard rate limits and requires the 'e-commerce' scope for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Quote
ID
: post_create_a_quoteOperation
: writeEntities
: property, association, quoteSummary
: This API endpoint allows you to create a quote with specified properties and associations. It requires authorization via a Bearer token and accepts a JSON body containing 'associations' and 'properties'. The 'associations' parameter is an array of objects that define the types and target object IDs for associations. The 'properties' parameter is an object containing key-value pairs for the quote's properties. Upon successful creation, the API returns a 201 status code along with the created quote's details, including its ID, creation timestamp, and properties with history. In case of errors, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Ticket
ID
: post_create_a_ticketOperation
: writeEntities
: property, association, ticketSummary
: This API endpoint allows you to create a ticket with specified properties and associations in HubSpot. The request requires authentication via a Bearer token and must include a JSON body with 'associations' and 'properties'. The 'associations' field is an array of objects that define the types and target object IDs for associations. The 'properties' field is an object containing key-value pairs for ticket properties. Upon successful creation, the API returns a 201 status code along with the ticket's details, including its ID, creation timestamp, and properties. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create an Association Between Object Types
ID
: post_create_associationOperation
: writeEntities
: association, schema, object typeSummary
: This API endpoint creates a new association between a primary schema's object type and another object type. The request requires the 'content-type' header to be set to 'application/json'. The path parameter 'objectType' is required to specify the fully qualified name or object type ID of your schema. The body of the request must include 'fromObjectTypeId' (ID of the primary object type), 'name' (a unique name for the association), and 'toObjectTypeId' (ID of the target object type). Upon successful creation, the response includes details such as 'createdAt', 'fromObjectTypeId', 'name', 'id', 'toObjectTypeId', and 'updatedAt'.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Calls
ID
: post_create_batch_of_callsOperation
: writeEntities
: property, association, callSummary
: This API endpoint allows you to create a batch of calls in HubSpot. It requires authentication via OAuth or private apps. The request body must include an array of call objects, each with associations and properties. The associations define the relationships of the call with other objects, while properties define the call's attributes. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the batch operation, including the created calls and their properties. The API returns a status of the operation, which can be 'PENDING', 'COMPLETED', or 'ERROR'.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Carts
ID
: post_create_batch_of_cartsOperation
: writeEntities
: cart, association, propertySummary
: This API endpoint allows you to create a batch of carts in HubSpot. It requires authentication via OAuth or private apps. The request body must include an array of cart objects, each containing properties such as 'hs_cart_name', 'hs_currency_code', and 'hs_external_cart_id'. Associations can also be specified for each cart. The response will include details about the creation status of each cart, including timestamps and properties. The API supports standard rate limits and requires the 'crm.objects.carts.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Communications
ID
: post_create_batch_of_communicationsOperation
: writeEntities
: property, association, communicationSummary
: This API endpoint allows you to create a batch of communications in HubSpot. It requires authentication via a Bearer token and accepts a JSON body containing an array of communication objects. Each communication object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each communication created, including its properties and history. The API supports OAuth and requires the 'crm.objects.contacts.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Companies
ID
: post_create_batch_of_companiesOperation
: writeEntities
: property, association, companySummary
: This API endpoint allows you to create a batch of companies in HubSpot. It requires the 'crm.objects.companies.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. The body of the request should contain an array of company objects, each with optional associations and properties. The response will include timestamps for when the operation was requested, started, and completed, as well as details about each company created, including their properties and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Contacts
ID
: post_create_batch_of_contactsOperation
: writeEntities
: property, association, contactSummary
: This API endpoint allows you to create a batch of contacts in HubSpot. It requires the 'crm.objects.contacts.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. The body of the request should contain an array of contact objects, each with optional associations and properties. The response will include timestamps for when the operation was requested, started, and completed, as well as details about the created contacts, including their properties and history. The status of the operation will also be provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of CRM Objects
ID
: post_create_batch_of_crm_objectsOperation
: writeEntities
: property, association, objectSummary
: This API endpoint allows you to create a batch of CRM objects in HubSpot. You need to specify the object type as a path parameter. The request body should contain an array of objects to be created, each with its properties and associations. The API requires authentication via a Bearer token. The response includes timestamps for when the request was made, started, and completed, along with the status of the operation and details of the created objects. The API supports various scopes for different CRM object types.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Discounts
ID
: post_create_batch_of_discountsOperation
: writeEntities
: discount, association, propertySummary
: This API endpoint allows the creation of a batch of discounts in the CRM system. It requires authentication via a Bearer token and accepts a JSON body containing an array of discount objects. Each discount object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, along with the results of the operation, including the properties and history of each created discount. The API supports standard and granular scopes for e-commerce and CRM objects line items write access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Emails
ID
: post_create_batch_of_emailsOperation
: writeEntities
: contact, emailSummary
: This API endpoint allows you to create a batch of emails in HubSpot. It requires authorization via a Bearer token and accepts a JSON body containing an array of email objects. Each email object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about the created emails, including their properties and history. The API supports standard and granular scopes and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Leads
ID
: post_create_batch_of_leadsOperation
: writeEntities
: lead, association, propertySummary
: This API endpoint allows you to create a batch of leads in HubSpot. It requires the 'crm.objects.leads.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. The body of the request should contain an array of lead objects, each with optional associations and properties. The response will include timestamps for when the operation was requested, started, and completed, as well as details about each lead created, including their properties and history. The status of the operation will be indicated in the response.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Line Items
ID
: post_create_batch_of_line_itemsOperation
: writeEntities
: property, association, line itemSummary
: This API endpoint allows you to create a batch of line items in HubSpot. It requires authentication via a Bearer token and accepts a JSON body containing an array of line items. Each line item can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each created line item, including its properties and history. The API supports standard and granular scopes for e-commerce and line item writing, respectively.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Meetings
ID
: post_create_batch_of_meetingsOperation
: writeEntities
: property, association, meetingSummary
: This API endpoint allows the creation of a batch of meetings in HubSpot. It requires authorization via a Bearer token and accepts a JSON body containing an array of meeting objects. Each meeting object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, along with the results of the created meetings. The API supports standard rate limits and requires the 'crm.objects.contacts.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Notes
ID
: post_create_batch_of_notesOperation
: writeEntities
: property, association, noteSummary
: This API endpoint allows you to create a batch of notes in HubSpot. It requires authentication via a Bearer token and accepts a JSON body containing an array of note objects. Each note object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each note created, including its properties and history. The API supports OAuth and requires the 'crm.objects.contacts.write' scope. It adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Orders
ID
: post_create_batch_of_ordersOperation
: writeEntities
: property, association, orderSummary
: This API endpoint allows you to create a batch of orders in HubSpot. It requires authentication via OAuth and the 'crm.objects.orders.write' scope. The request body must include an array of order objects, each containing associations and properties. The response will include timestamps for when the operation was requested, started, and completed, as well as details about each order created. If errors occur, they will be detailed in the response, including error categories, messages, and context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Postal Mail
ID
: post_create_batch_of_postal_mailOperation
: writeEntities
: property, association, postal mailSummary
: This API endpoint allows you to create a batch of postal mail objects in HubSpot. It requires authentication via OAuth and the 'crm.objects.contacts.write' scope. The request body must include an array of postal mail objects, each with associations and properties. The response includes timestamps for when the request was completed, started, and requested, as well as details about each postal mail object created, including its properties and history. The API returns a status of 'PENDING' upon successful creation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Products
ID
: post_create_batch_of_productsOperation
: writeEntities
: property, association, productSummary
: This API endpoint allows you to create a batch of products in HubSpot. It requires an authorization bearer token and a content-type header set to application/json. The request body must include an array of product objects, each containing associations and properties. The associations define relationships with other objects, while properties define the product's attributes such as name, price, and SKU. The response includes timestamps for when the operation was requested, started, and completed, along with the status of the operation and details of each created product.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Properties
ID
: post_create_batch_of_propertiesOperation
: writeEntities
: property, option, modification metadataSummary
: This API endpoint allows you to create a batch of properties for a specified object type in HubSpot. The request requires authentication via a Bearer token and the object type as a path parameter. The body of the request should contain an array of property objects, each with attributes such as 'hidden', 'displayOrder', 'description', 'label', 'type', 'formField', 'groupName', 'referencedObjectType', 'name', 'options', 'calculationFormula', 'hasUniqueValue', 'fieldType', and 'externalOptions'. The response will include details about the created properties, including their creation and update timestamps, and their status. The API supports standard and granular scopes and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Quotes
ID
: post_create_batch_of_quotesOperation
: writeEntities
: property, association, quoteSummary
: This API endpoint allows the creation of a batch of quotes in HubSpot. It requires authentication via OAuth or private apps. The request body must include an array of quote objects, each containing associations and properties. The associations define the relationships of the quote with other objects, while properties define the attributes of the quote. The response includes timestamps for the request, start, and completion of the operation, links related to the operation, and the results for each quote created. The status of the operation is also provided. The API adheres to standard API rate limits and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Tasks
ID
: post_create_batch_of_tasksOperation
: writeEntities
: property, association, taskSummary
: This API endpoint allows you to create a batch of tasks in HubSpot. It requires authorization via a Bearer token and accepts a JSON body containing an array of task objects. Each task object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each created task, including its properties and history. The API supports OAuth and private apps, and requires the 'crm.objects.contacts.write' scope. The response can vary based on the operation's success, with HTTP 201 indicating successful creation and HTTP 207 indicating multiple statuses.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Taxes
ID
: post_create_batch_of_taxesOperation
: writeEntities
: property, tax, associationSummary
: This API endpoint allows you to create a batch of tax objects in HubSpot. It requires authentication via OAuth and the 'crm.objects.line_items.write' scope. The request body must include an array of tax objects, each with associations and properties. The response will include timestamps for when the request was made, started, and completed, as well as details about each created tax object, including its properties and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Batch of Tickets
ID
: post_create_batch_of_ticketsOperation
: writeEntities
: property, association, ticketSummary
: This API endpoint allows you to create a batch of tickets in HubSpot. It requires authentication via a Bearer token and accepts a JSON body containing an array of ticket objects. Each ticket object can have associations and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each created ticket, including its properties and history. The API adheres to standard rate limits and requires the 'tickets' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Call with Given Properties
ID
: post_create_call_with_given_propertiesOperation
: writeEntities
: property, association, callSummary
: This API endpoint allows you to create a call with specified properties and associations in HubSpot. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes 'associations', which is an array of objects defining the types and target ID of the association, and 'properties', which is an object containing additional properties of the call. Upon successful creation, the API returns a 201 status code along with the details of the created call, including its ID, creation timestamp, and properties. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Contact in HubSpot CRM
ID
: post_create_contact_in_hubspot_crmOperation
: writeEntities
: property, association, contactSummary
: This API endpoint allows you to create a contact in HubSpot CRM with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes 'associations' and 'properties'. Associations are defined as an array of objects, each containing types and a target object ID. Properties are defined as an object with additional properties. Upon successful creation, the API returns a 201 status code with the contact's details, including its ID, creation timestamp, and properties with history. In case of errors, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create CRM Object
ID
: post_create_crm_objectOperation
: writeEntities
: property, association, objectSummary
: This API endpoint allows you to create a CRM object with specified properties and associations. The request requires a path parameter 'objectType' to specify the type of CRM object to create. The request body includes 'associations' and 'properties' to define the relationships and attributes of the object. The response returns the created object, including its ID, creation timestamp, and properties with history. The API requires authentication via a Bearer token and supports various scopes for access control. In case of errors, detailed error messages and context are provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Default Associations
ID
: post_create_default_associationsOperation
: writeEntities
: association, scope, object typeSummary
: The Create Default Associations API allows you to create the default (most generic) association type between two object types in HubSpot. It requires authentication via a Bearer token and supports various scopes for access. The API accepts path parameters 'fromObjectType' and 'toObjectType' to specify the types of objects being associated. The request body must include an array of 'inputs', each containing 'from' and 'to' objects with their respective IDs. The response includes timestamps for the request, start, and completion of the operation, along with any errors encountered. The results array provides details of the associations created, and any errors are detailed in the errors array.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Email with Given Properties
ID
: post_create_email_with_given_propertiesOperation
: writeEntities
: property, association, emailSummary
: This API endpoint allows you to create an email with specified properties and associations. The request requires authorization via a Bearer token and must include a JSON body with 'associations' and 'properties'. The 'associations' field is an array of objects that define the types and target ID of the associations. The 'properties' field is an object containing key-value pairs for the email properties. Upon successful creation, the API returns a 201 status code along with the created email's details, including its ID, creation timestamp, and properties with history. In case of errors, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Event Template for App
ID
: post_create_event_template_for_appOperation
: writeEntities
: CRM object, token, event templateSummary
: This API endpoint allows developers to create an event template for their app. Event templates define the structure for a custom timeline event, including formatted copy for its heading and details, as well as any custom property definitions. The API requires the app ID as a path parameter and the developer's API key as a query parameter. The request body must include the detail template, name, tokens, header template, and object type. The response includes the created event template's ID, object type, creation and update timestamps, name, header template, detail template, and tokens.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Fee with Given Properties
ID
: post_create_fee_with_given_propertiesOperation
: writeEntities
: property, association, feeSummary
: This API endpoint allows you to create a fee with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes 'associations', which is an array of objects defining the types and target object IDs, and 'properties', which is an object containing key-value pairs for the fee's properties. Upon successful creation, the API returns a 201 status code along with the created fee's details, including its ID, creation timestamp, and properties with history. In case of errors, a detailed error message is provided with context and remediation steps.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Folder in HubSpot CRM
ID
: post_create_folder_in_hubspot_crmOperation
: writeEntities
: user, scope, folderSummary
: This API creates a folder in the HubSpot CRM. It requires authorization via a Bearer token and accepts JSON input specifying the name of the folder and optionally the parent folder ID. The response includes details of the created folder such as its ID, name, creation timestamp, and other metadata. If the parent folder ID is not specified, the folder is created in the root directory. The API requires 'crm.lists.write' and 'crm.lists.read' scopes and is subject to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Line Item
ID
: post_create_line_itemOperation
: writeEntities
: property, association, line itemSummary
: This API endpoint allows you to create a line item with specified properties and associations in HubSpot. The request requires authorization via a Bearer token and must include a JSON body with 'associations' and 'properties'. The 'associations' field is an array of objects that define the association types and the associated object ID. The 'properties' field is an object containing key-value pairs for the line item's properties. Upon successful creation, the API returns a 201 status code along with the created line item's details, including its ID, properties, and timestamps. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create List
ID
: post_create_listOperation
: writeEntities
: list, property, filterSummary
: The Create List API allows users to create a new list with a specified object list definition. It requires the 'crm.lists.write' scope and adheres to standard API rate limits. The request body must include the 'objectTypeId', 'processingType', and 'name' parameters, while 'customProperties', 'listFolderId', and 'filterBranch' are optional. The response includes details about the created list, such as its processing type, object type ID, list ID, creation time, and more. In case of errors, detailed error messages and context are provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Multiple Timeline Events
ID
: post_create_multiple_timeline_eventsOperation
: writeEntities
: template, contact, eventSummary
: This API endpoint allows the creation of multiple timeline events in batches based on an event template. The events are immutable once created and can update object properties if configured. The request requires an array of event objects, each containing details such as email, tokens, extra data, timeline iframe details, and an event template ID. The response includes the status of the batch operation, timestamps, and details of each created event.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a New Card for HubSpot CRM
ID
: post_create_new_cardOperation
: writeEntities
: account, contact, cardSummary
: This API endpoint allows developers to create a new card for HubSpot CRM. The card becomes active when the app is installed. The request requires a developer API key and includes parameters such as the app ID, card configuration details, and display properties. The response includes details about the created card, such as its title, fetch configuration, display properties, and actions. The API supports custom user actions and allows specifying CRM object types where the card should be displayed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a New CRM Object Schema
ID
: post_create_new_crm_object_schemaOperation
: writeEntities
: property, association, object schemaSummary
: This API endpoint allows you to create a new CRM object schema in HubSpot. You can define a new object type, its properties, and associations. The request body includes parameters such as 'secondaryDisplayProperties', 'requiredProperties', 'searchableProperties', 'primaryDisplayProperty', 'name', 'description', 'associatedObjects', 'properties', and 'labels'. The response returns the entire object schema, including its object type ID, properties, and associations. The response also includes metadata such as creation and update timestamps, user IDs, and property details.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Note in HubSpot CRM
ID
: post_create_note_in_hubspot_crmOperation
: writeEntities
: property, association, noteSummary
: This API endpoint allows you to create a note in HubSpot CRM with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes an array of associations and a properties object. The response returns a copy of the created note object, including its ID, creation timestamp, and properties with history. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Replace Deal Splits for Deals
ID
: post_create_or_replace_deal_splitsOperation
: writeEntities
: deal, split, ownerSummary
: This API endpoint allows you to create or replace deal splits for deals with the provided IDs. The deal split percentages for each deal must sum up to 1.0 (100%) and can have up to 8 decimal places. The request requires an authorization bearer token and a content-type header set to application/json. The body of the request should contain an array of inputs, each with an array of splits specifying the percentage and ownerId, and the deal id. The response includes timestamps for when the operation was requested, started, and completed, along with the results of the operation, which include details about each split such as creation and update timestamps, archived status, and properties. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Calls by Unique Property Values
ID
: post_create_or_update_batch_callsOperation
: writeEntities
: property, call, errorSummary
: This API endpoint allows you to create or update a batch of call records in the CRM by specifying unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of call records, each identified by a unique property specified by the idProperty parameter. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each call record processed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Communications by Unique Property Values
ID
: post_create_or_update_batch_communicationsOperation
: writeEntities
: property, contact, communicationSummary
: This API endpoint allows you to create or update a batch of communication records identified by a unique property value specified by the idProperty query parameter. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of inputs, each with an idProperty, id, and additional properties. The response includes timestamps for when the operation was requested, started, and completed, as well as details of the results and any errors encountered. The API requires the crm.objects.contacts.write scope and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Contacts by Unique Property Values
ID
: post_create_or_update_batch_contactsOperation
: writeEntities
: property, contact, errorSummary
: This API endpoint allows you to create or update a batch of contact records in HubSpot CRM by specifying unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of contact records, each with an idProperty indicating the unique property, an id, and a set of properties. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the operation, including the created or updated contacts and their properties. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Discounts by Unique Property Values
ID
: post_create_or_update_batch_discountsOperation
: writeEntities
: discount, error, propertySummary
: This API endpoint allows you to create or update a batch of discount records in the CRM system by specifying unique property values. The request requires an authorization token and a content-type header. The body of the request should contain an array of discount objects, each identified by a unique property specified by the 'idProperty' field. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each discount record processed. The API supports standard and granular scopes for e-commerce and CRM objects line items write operations.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Emails by Unique Property Values
ID
: post_create_or_update_batch_emailsOperation
: writeEntities
: property, email, errorSummary
: This API endpoint allows you to create or update a batch of email records identified by a unique property value specified by the idProperty query parameter. The request requires authorization via a Bearer token and the content type must be set to application/json. The body of the request should contain an array of email records, each with a unique idProperty, id, and a set of properties. The response will include timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each email record processed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Line Items by Unique Property Values
ID
: post_create_or_update_batch_line_itemsOperation
: writeEntities
: property, line item, errorSummary
: This API endpoint allows you to create or update a batch of line items in the CRM by specifying unique property values. The request requires an authorization token and a content-type header. The body of the request should contain an array of line items, each with a unique idProperty, an id, and a set of properties. The response will include timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each line item processed. The API supports standard and granular scopes for e-commerce and CRM objects, and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Meetings by Unique Property Values
ID
: post_create_or_update_batch_meetingsOperation
: writeEntities
: property, meeting, errorSummary
: This API endpoint allows you to create or update a batch of meeting records in HubSpot CRM by specifying unique property values. The request requires an authorization bearer token and a content-type header set to application/json. The body of the request should contain an array of meeting records, each identified by a unique property specified by the 'idProperty' field. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each meeting record processed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Notes by Unique Property Values
ID
: post_create_or_update_batch_notesOperation
: writeEntities
: property, error, noteSummary
: This API endpoint allows you to create or update a batch of notes in the CRM system by specifying unique property values. The request requires an authorization bearer token and a content-type header set to application/json. The body of the request should contain an array of inputs, each with an idProperty, id, and additional properties. The idProperty is a unique identifier for the note. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of the notes processed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of CRM Objects by Unique Property Values
ID
: post_create_or_update_batch_objectsOperation
: writeEntities
: property, scope, objectSummary
: This API endpoint allows you to create or update a batch of CRM objects identified by a unique property value specified by the idProperty query parameter. The endpoint requires authentication via a Bearer token and supports various scopes for access control. The request body must include an array of objects with their unique idProperty, id, and properties. The response provides details about the operation's completion, including timestamps, links, and results for each object processed. The API supports standard API rate limits and returns detailed error information in case of validation errors.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Carts by Unique Property Values
ID
: post_create_or_update_batch_of_cartsOperation
: writeEntities
: cartSummary
: This API endpoint allows you to create or update a batch of cart records in HubSpot CRM by specifying unique property values. The unique property is defined by the 'idProperty' query parameter. The request requires authentication via a Bearer token and the content type must be 'application/json'. The request body should include an array of cart objects, each with a unique 'idProperty', 'id', and a set of properties such as 'hs_cart_name', 'hs_currency_code', and 'hs_external_cart_id'. The response will include timestamps for when the operation was requested, started, and completed, along with the status of the operation and details of the cart records processed.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Companies by Unique Property Values
ID
: post_create_or_update_batch_of_companiesOperation
: writeEntities
: property, company, errorSummary
: This API endpoint allows you to create or update a batch of company records in HubSpot CRM by specifying unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of company records, each identified by a unique property specified by the 'idProperty' field. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each company record processed, including creation and update timestamps, properties, and status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Deals by Unique Property Values
ID
: post_create_or_update_batch_of_dealsOperation
: writeEntities
: property, deal, errorSummary
: This API endpoint allows you to create or update a batch of deals in HubSpot CRM by specifying unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of deal objects, each with an idProperty, id, and properties. The idProperty is a unique identifier for the object. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the operation, including the properties and history of each deal. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Fees by Unique Property Values
ID
: post_create_or_update_batch_of_feesOperation
: writeEntities
: property, fee, errorSummary
: This API endpoint allows you to create or update a batch of fee records identified by a unique property value specified by the idProperty query parameter. The request requires authorization via a Bearer token and the content type must be set to application/json. The body of the request should contain an array of inputs, each with an idProperty, id, and properties. The response will include timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each record processed. The API supports standard e-commerce and granular CRM scopes, and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Leads by Unique Property Values
ID
: post_create_or_update_batch_of_leadsOperation
: writeEntities
: lead, error, propertySummary
: This API endpoint allows you to create or update a batch of leads in the CRM system by specifying unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of lead objects, each with a unique idProperty, id, and a set of properties. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each lead processed. The API supports OAuth and requires the 'crm.objects.leads.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Products by Unique Property Values
ID
: post_create_or_update_batch_of_productsOperation
: writeEntities
: property, error, productSummary
: This API endpoint allows you to create or update a batch of product records in the CRM system by specifying unique property values. The request requires an array of product records, each identified by a unique property specified by the 'idProperty' parameter. The request body must include the 'inputs' array containing objects with 'idProperty', 'id', and 'properties'. The response provides details about the operation, including timestamps, links, and the status of each product record processed. The API supports standard e-commerce scopes and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Quotes by Unique Property Values
ID
: post_create_or_update_batch_of_quotesOperation
: writeEntities
: property, error, quoteSummary
: This API endpoint allows you to create or update a batch of quotes identified by a unique property value specified by the idProperty query parameter. The request requires an array of quote objects, each containing an idProperty, id, and additional properties. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each quote processed. The API requires authentication via a Bearer token and supports standard and granular scopes for e-commerce and CRM objects.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Taxes by Unique Property Values
ID
: post_create_or_update_batch_of_taxesOperation
: writeEntities
: property, tax, errorSummary
: This API endpoint allows you to create or update a batch of tax records identified by a unique property value specified by the idProperty query parameter. The request requires authorization via a Bearer token and a content-type of application/json. The body of the request should contain an array of objects, each with an idProperty, id, and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the operation, including the properties and history of each object. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Tickets by Unique Property Values
ID
: post_create_or_update_batch_of_ticketsOperation
: writeEntities
: property, ticket, errorSummary
: This API endpoint allows you to create or update a batch of tickets in the CRM system by specifying unique property values. The request requires an authorization token and a content-type header. The body of the request should contain an array of inputs, each with an idProperty, id, and additional properties. The response will include timestamps for when the operation was requested, started, and completed, as well as details about the created or updated tickets, including their properties and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Orders by Unique Property Values
ID
: post_create_or_update_batch_ordersOperation
: writeEntities
: orderSummary
: This API endpoint allows you to create or update a batch of orders identified by unique property values. The unique property is specified by the 'idProperty' query parameter. The request requires authentication via a Bearer token and the content type must be 'application/json'. The request body should contain an array of order objects, each with an 'idProperty', 'id', and 'properties'. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each order processed. The API supports standard rate limits and requires the 'crm.objects.orders.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Postal Mail by Unique Property Values
ID
: post_create_or_update_batch_postal_mailOperation
: writeEntities
: property, postal mail, errorSummary
: This API endpoint allows you to create or update a batch of postal mail records identified by a unique property value specified by the idProperty query parameter. The request requires an authorization bearer token and a content-type header set to application/json. The body of the request should contain an array of objects, each with an idProperty, id, and properties. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the operation, including the properties and history of each object. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create or Update a Batch of Tasks by Unique Property Values
ID
: post_create_or_update_batch_tasksOperation
: writeEntities
: link, error, taskSummary
: This API endpoint allows you to create or update a batch of tasks in HubSpot CRM by specifying unique property values. The tasks are identified by a unique property value provided in the 'idProperty' field. The request body must include an array of task objects, each containing 'idProperty', 'id', and 'properties'. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each task processed. The API requires authorization via a Bearer token and supports OAuth and private apps.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Order
ID
: post_create_orderOperation
: writeEntities
: property, association, orderSummary
: This API endpoint allows you to create an order with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should include an array of associations, each with a category and type ID, and a target object ID. Additionally, you can specify properties for the order as key-value pairs. Upon successful creation, the API returns a 201 status code along with the order's ID, creation timestamp, and other details. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Pipeline Stage
ID
: post_create_pipeline_stageOperation
: writeEntities
: metadata, stage, pipelineSummary
: This API endpoint allows you to create a new stage associated with a specified pipeline in HubSpot. The endpoint requires the objectType and pipelineId as path parameters. The request body must include the displayOrder and label for the new stage, and optionally metadata such as probability for deals or ticketState for tickets. The response returns the entire stage object, including its unique ID, creation date, and other metadata. The API requires authorization via a Bearer token and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create Postal Mail
ID
: post_create_postal_mailOperation
: writeEntities
: postal mailSummary
: This API endpoint allows you to create a postal mail object in the CRM system. It requires authentication via a Bearer token and accepts a JSON body with associations and properties. The associations array can include multiple association types and target objects. The properties object can include various key-value pairs representing the postal mail's attributes. Upon successful creation, the API returns a 201 status code along with the created postal mail object, including its ID, creation timestamp, and properties with history. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Property for a Specified Object Type
ID
: post_create_property_for_specified_object_typeOperation
: writeEntities
: property, user, object typeSummary
: This API endpoint allows you to create a new property for a specified object type in HubSpot. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The objectType path parameter specifies the type of object for which the property is being created. The request body includes various parameters such as hidden, displayOrder, description, label, type, groupName, name, fieldType, formField, referencedObjectType, options, calculationFormula, hasUniqueValue, and externalOptions. The response returns details about the created property, including its ID, visibility, metadata, display order, description, label, type, group name, options, and timestamps for creation and updates.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Property Group
ID
: post_create_property_groupOperation
: writeEntities
: scope, error, property groupSummary
: This API creates a new property group for a specified object type in HubSpot. It requires authentication via a Bearer token and accepts a JSON body with the parameters 'name', 'displayOrder', and 'label'. The 'name' is the internal name used for referencing the property group, 'displayOrder' determines the order of display, and 'label' is a human-readable label. The response includes the details of the created property group, including whether it is archived, its name, display order, and label.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Single Timeline Event
ID
: post_create_single_timeline_eventOperation
: writeEntities
: template, contact, eventSummary
: This API endpoint creates a single timeline event based on a specified event template. The event is immutable once created and may update object properties if configured. The request requires an event template ID and a CRM object identifier, with optional parameters for additional data, iframe details, domain, tokens, and contact information. The response includes the event's unique ID, associated object type, and other details. Errors are returned with detailed context and remediation steps.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Task in HubSpot CRM
ID
: post_create_task_in_hubspot_crmOperation
: writeEntities
: property, association, taskSummary
: This API endpoint allows you to create a task in HubSpot CRM with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes 'associations' and 'properties'. Associations are defined as an array of objects, each containing 'types' and 'to' fields. Properties are defined as an object with additional properties. Upon successful creation, the API returns a 201 status code with details of the created task, including its ID, creation timestamp, and properties. If there is an error, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create a Tax Object
ID
: post_create_tax_objectOperation
: writeEntities
: property, tax, associationSummary
: This API endpoint allows you to create a tax object with specified properties and associations. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes an array of associations and a properties object with additional properties. Upon successful creation, the API returns a copy of the tax object, including its ID, creation timestamp, and other details. The response also includes properties with history, showing changes over time. If there is an error, a detailed error message with context and remediation steps is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Create User Defined Association Definition
ID
: post_create_user_defined_association_definitionOperation
: writeEntities
: label, association definition, categorySummary
: This API endpoint allows the creation of a user-defined association definition between two object types in HubSpot. The request requires authorization via a Bearer token and must include the content type as 'application/json'. The path parameters 'fromObjectType' and 'toObjectType' specify the object types involved in the association. The request body must include 'inverseLabel', 'name', and 'label' to define the association. The response returns an array of results with each result containing 'typeId', 'label', and 'category' of the association.Input Fields
: Input FieldsOutput Fields
: Output Fields
Delete Specific Association Labels
ID
: post_delete_specific_association_labelsOperation
: writeEntities
: label, association, objectSummary
: This API endpoint allows for batch deletion of specific association labels between objects in HubSpot. It requires authentication via a bearer token and supports various scopes for access. The request includes path parameters for the object types involved, and a body containing details of the associations to be deleted. The response is typically a 204 No Content on success, but may include detailed error information if something goes wrong.Input Fields
: Input FieldsOutput Fields
: Output Fields
GDPR Delete Contact
ID
: post_gdpr_delete_contactOperation
: writeEntities
: GDPR, content, contactSummary
: The GDPR Delete Contact API permanently deletes a contact and all associated content to comply with GDPR regulations. It allows identifying the contact by a unique property, such as an email address, using the 'idProperty' parameter. If the email address is not found, it is added to a blocklist to prevent future use. The API requires 'crm.objects.contacts.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token and a JSON body with 'idProperty' and 'objectId'. A successful request returns a 204 No Content response. In case of errors, a detailed error object is returned with information about the error category, message, and context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Generate High Usage Report for User
ID
: post_generate_high_usage_report_for_userOperation
: writeEntities
: usage report, error, userSummary
: This API endpoint generates a high usage report for a specified user. It requires a valid OAuth token with appropriate scopes for authorization. The userId is a path parameter that specifies the user for whom the report is generated. The response includes the user's email, userId, and enqueue time details. In case of errors, a detailed error object is returned with information about the error category, message, and context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Mark Recording as Ready for Transcription
ID
: post_mark_recording_as_ready_for_transcriptionOperation
: writeEntities
: recording, call, transcriptionSummary
: This API marks a call recording as ready for transcription by specifying the call using its engagement ID. It requires the 'crm.schemas.contacts.write' or 'crm.objects.contacts.write' scopes for authentication. The request must include the engagement ID in the body and the authorization bearer token in the headers. A successful request returns a 204 No Content response. In case of errors, a detailed error object is returned with information such as subCategory, context, correlationId, links, message, category, and errors array.Input Fields
: Input FieldsOutput Fields
: Output Fields
Merge Two Companies with Same Type
ID
: post_merge_two_companies_with_same_typeOperation
: writeEntities
: property, company, errorSummary
: This API endpoint allows you to merge two companies of the same type in HubSpot. It requires the IDs of the two companies: 'objectIdToMerge' for the company to be merged and 'primaryObjectId' for the primary company that will remain after the merge. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. Upon successful merging, the API returns details of the merged company, including creation and update timestamps, properties, and history. If an error occurs, a detailed error message is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Merge Two Contacts with Same Type
ID
: post_merge_two_contacts_with_same_typeOperation
: writeEntities
: property, contact, errorSummary
: This API endpoint merges two contacts of the same type in HubSpot. It requires the IDs of the contact to be merged and the primary contact. The request must include an authorization bearer token and specify the content type as JSON. Upon successful merging, it returns details of the merged contact including creation and update timestamps, properties, and history of changes. If an error occurs, it provides detailed error information including missing scopes, invalid property names, and a correlation ID for support.Input Fields
: Input FieldsOutput Fields
: Output Fields
Merge Two Deals with Same Type
ID
: post_merge_two_deals_with_same_typeOperation
: writeEntities
: property, deal, errorSummary
: This API endpoint merges two deals of the same type in HubSpot. It requires the IDs of the two deals: 'objectIdToMerge' for the deal to be merged and 'primaryObjectId' for the primary deal. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. Upon successful merging, the API returns details of the merged deal, including creation and update timestamps, properties, and history. In case of an error, a detailed error message is provided with context and remediation steps.Input Fields
: Input FieldsOutput Fields
: Output Fields
Merge Two Tickets with Same Type
ID
: post_merge_two_tickets_with_same_typeOperation
: writeEntities
: ticketSummary
: This API endpoint allows you to merge two tickets of the same type in the CRM system. It requires the IDs of the two tickets: 'objectIdToMerge' for the ticket to be merged and 'primaryObjectId' for the primary ticket. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. Upon successful merging, the response includes details of the merged ticket such as creation and update timestamps, properties, and history of changes. In case of an error, a detailed error message with context and remediation steps is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Calls by Internal ID or Unique Property Values
ID
: post_read_batch_callsOperation
: readEntities
: property, call, errorSummary
: This API endpoint allows you to read a batch of calls by their internal ID or unique property values. It requires the 'crm.objects.contacts.read' scope and adheres to standard API rate limits. The request can include optional query parameters such as 'archived' to filter archived results. The request body can include 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' to specify the details of the calls to be retrieved. The response includes timestamps for completion, request, and start, along with links, results, and status. Each result contains details such as creation and update timestamps, archived status, properties with history, and more.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Commerce Payments by Internal ID or Unique Property Values
ID
: post_read_batch_commerce_paymentsOperation
: readEntities
: property, commerce payment, errorSummary
: This API endpoint allows you to read a batch of commerce payments by their internal ID or unique property values. It requires authorization via a Bearer token and accepts various parameters in the request body, including 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties'. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each payment, such as creation and update times, properties, and archival status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Communications by Internal ID or Unique Property Values
ID
: post_read_batch_communicationsOperation
: readEntities
: contact, communicationSummary
: This API endpoint allows you to read a batch of communications by internal ID or unique property values. It requires the 'crm.objects.contacts.read' scope and adheres to standard API rate limits. The request can include optional query parameters such as 'archived' to filter results based on their archived status. The request body can include 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' to specify the details of the communications to be read. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the operation, which include details about each communication such as creation and update timestamps, properties, and archival status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Contacts by Internal ID or Unique Property Values
ID
: post_read_batch_contactsOperation
: readEntities
: property, contact, errorSummary
: This API endpoint allows you to read a batch of contacts by their internal ID or unique property values. It requires authentication via OAuth or private apps. The request can include properties with history, a unique property name, and a list of contact IDs. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of the contacts retrieved. The API supports filtering by archived status and returns detailed information about each contact, including their properties and history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of CRM Objects by Internal ID or Unique Property Values
ID
: post_read_batch_crm_objectsOperation
: readEntities
: property, object, historySummary
: This API endpoint allows you to read a batch of CRM objects by their internal ID or unique property values. It requires authentication via a bearer token and supports various scopes for access control. The request can specify the object type as a path parameter and can include optional query parameters such as 'archived' to filter results. The request body can include arrays of properties with history, unique property names, and object IDs to retrieve specific data. The response includes timestamps for the operation, links, and detailed results for each object, including their properties and history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Deal Split Objects by Deal Object Internal ID
ID
: post_read_batch_deal_split_objectsOperation
: readEntities
: deal, error, splitSummary
: This API endpoint allows you to read a batch of deal split objects by their associated deal object internal ID. It requires the 'crm.dealsplits.read_write' scope for authentication. The request is made via a POST method to the specified URL with a JSON body containing an array of deal object internal IDs. The response includes timestamps for when the request was made, started, and completed, along with the results of the operation, which include details about each split object such as creation time, archival status, properties, and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Discounts by Internal ID or Unique Property Values
ID
: post_read_batch_discountsOperation
: readEntities
: discount, error, propertySummary
: This API endpoint allows you to read a batch of discounts by their internal ID or unique property values. It requires authentication via OAuth or private apps. The request can include properties with history, an ID property, inputs with discount IDs, and specific properties to retrieve. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each discount, including creation and update timestamps, properties, and archival status. The API supports standard and granular scopes for e-commerce and CRM objects line items read.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Emails by Internal ID or Unique Property Values
ID
: post_read_batch_emailsOperation
: readEntities
: property, email, errorSummary
: This API endpoint allows you to read a batch of emails by their internal ID or unique property values. It requires authentication via a Bearer token and supports both private apps and OAuth. The request can include properties with history, a unique ID property, and a list of inputs with IDs. The response includes timestamps for when the request was completed, started, and requested, along with links and results containing details about each email, such as creation and update timestamps, properties, and archived status. The API supports filtering by archived status through a query parameter.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Feedback Submissions by Internal ID or Unique Property Values
ID
: post_read_batch_feedback_submissionsOperation
: readEntities
: id, feedback submission, propertySummary
: This API endpoint allows you to read a batch of feedback submissions by their internal ID or unique property values. It requires authorization via a Bearer token and accepts a JSON body with optional parameters such as 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties'. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as detailed information about each feedback submission, including its properties and history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Goal Targets by Internal ID or Unique Property Values
ID
: post_read_batch_goal_targetsOperation
: readEntities
: property, error, goal targetSummary
: This API endpoint allows you to read a batch of goal targets by their internal ID or unique property values. It requires authentication via a Bearer token and supports OAuth. The request can include properties with history, an ID property, and a list of inputs with IDs. You can also specify properties to be returned. The 'archived' query parameter determines whether only archived results are returned, with a default value of false. The response includes timestamps for when the operation was requested, started, and completed, as well as links and results with detailed properties and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Invoices by Internal ID or Unique Property Values
ID
: post_read_batch_invoicesOperation
: readEntities
: property, invoice, errorSummary
: This API endpoint allows you to read a batch of invoices by their internal ID or unique property values. It requires authentication via OAuth or private apps and the 'crm.objects.invoices.read' scope. The request can include optional parameters such as 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' in the body, and 'archived' as a query parameter to filter archived results. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each invoice, including its properties and history. The API adheres to standard rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Line Items by Internal ID or Unique Property Values
ID
: post_read_batch_line_itemsOperation
: readEntities
: property, line item, errorSummary
: This API endpoint allows you to read a batch of line items by their internal ID or unique property values. It requires authentication via OAuth or private apps. The request can include properties with history, an ID property, inputs with IDs, and other properties. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as links, results with detailed properties, and the status of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Meetings by Internal ID or Unique Property Values
ID
: post_read_batch_meetingsOperation
: readEntities
: property, meeting, errorSummary
: This API endpoint allows you to read a batch of meetings by their internal ID or unique property values. It requires authentication via OAuth or private apps. The request can include optional parameters such as 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' in the body, and 'archived' as a query parameter to filter archived meetings. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each meeting, including its properties and history. The API supports standard rate limits and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Notes by Internal ID or Unique Property Values
ID
: post_read_batch_notesOperation
: readEntities
: property, error, noteSummary
: This API endpoint allows you to read a batch of notes by their internal ID or unique property values. It requires authentication via a Bearer token and supports OAuth. The request can include optional query parameters such as 'archived' to filter results based on their archived status. The body of the request can include arrays of 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties'. The response includes timestamps for when the request was completed, started, and requested, as well as links and results containing details about each note, such as creation and update timestamps, properties, and archived status. The API adheres to standard rate limits and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Carts by Internal ID or Unique Property Values
ID
: post_read_batch_of_cartsOperation
: readEntities
: cart, error, propertySummary
: This API endpoint allows you to read a batch of carts by their internal ID or unique property values. It requires authentication via OAuth or private apps and the 'crm.objects.carts.read' scope. The request can include properties with history, a unique ID property, and an array of inputs with cart IDs. The response includes details about the operation's completion, links, and results with cart properties and history. The API supports filtering by archived status with a default value of false.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Companies by Internal ID or Unique Property Values
ID
: post_read_batch_of_companiesOperation
: readEntities
: property, company, errorSummary
: This API endpoint allows you to read a batch of companies by their internal ID or unique property values. It requires authentication via OAuth or private apps. The request can include optional query parameters such as 'archived' to filter results based on their archived status. The request body can include arrays of 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' to specify which properties and IDs to retrieve. The response includes timestamps for when the request was completed, started, and requested, as well as links and results containing company details such as creation time, archived status, properties with history, and more. The API supports standard rate limits and requires the 'crm.objects.companies.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Deals by Internal ID or Unique Property Values
ID
: post_read_batch_of_dealsOperation
: readEntities
: property, deal, errorSummary
: This API endpoint allows you to read a batch of deals by their internal ID or unique property values. It requires authentication via OAuth or private apps and the 'crm.objects.deals.read' scope. The request can include properties with history, a unique property name, and a list of deal IDs. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each deal, including its properties and history. The 'archived' query parameter can be used to filter results to only include archived deals.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Fees by Internal ID or Unique Property Values
ID
: post_read_batch_of_feesOperation
: readEntities
: property, fee, errorSummary
: This API endpoint allows you to read a batch of fees by internal ID or unique property values. It requires authorization via a Bearer token and accepts various parameters in the request body, including 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties'. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as links and results detailing the properties and history of the fees. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Leads by Internal ID or Unique Property Values
ID
: post_read_batch_of_leadsOperation
: readEntities
: lead, error, propertySummary
: This API endpoint allows you to read a batch of leads by their internal ID or unique property values. It requires the 'crm.objects.leads.read' scope and adheres to standard API rate limits. The request can include headers for authorization and content type, a query parameter to filter archived results, and a body with properties, idProperty, inputs, and propertiesWithHistory. The response includes timestamps for the operation, links, results with lead details, and the status of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Products by Internal ID or Unique Property Values
ID
: post_read_batch_of_productsOperation
: readEntities
: property, error, productSummary
: This API endpoint allows you to read a batch of products by their internal ID or unique property values. It requires authorization via a Bearer token and accepts various parameters in the request body, including 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties'. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as detailed information about each product, including its properties and history. The API supports standard e-commerce scopes and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Properties
ID
: post_read_batch_of_propertiesOperation
: readEntities
: property, option, object typeSummary
: This API endpoint allows you to read a batch of properties for a specified object type in HubSpot. It requires authentication via a Bearer token and supports various scopes for access. The request includes a path parameter 'objectType' to specify the type of object, and a body parameter 'inputs' which is an array of property names to be read. The response includes details about each property, such as its creation and modification metadata, display order, description, label, type, and options. The API supports standard rate limits and returns a detailed response including timestamps and status of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Quotes by Internal ID or Unique Property Values
ID
: post_read_batch_of_quotesOperation
: readEntities
: property, error, quoteSummary
: This API endpoint allows you to read a batch of quotes by their internal ID or unique property values. It requires authentication via a Bearer token and supports both private apps and OAuth. The request can include properties with history, an ID property, inputs with IDs, and additional properties. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as details about each quote, including its properties and history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Taxes by Internal ID or Unique Property Values
ID
: post_read_batch_of_taxesOperation
: readEntities
: property, tax, errorSummary
: This API endpoint allows users to read a batch of tax objects by their internal ID or unique property values. It requires authentication via OAuth and the 'crm.objects.line_items.read' scope. The request can include optional query parameters such as 'archived' to filter archived results. The request body can specify 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' to customize the response. The response includes timestamps for when the operation was requested, started, and completed, as well as details about the tax objects, including their properties and history. The API adheres to standard rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Orders by Internal ID or Unique Property Values
ID
: post_read_batch_ordersOperation
: readEntities
: property, order, errorSummary
: This API endpoint allows you to read a batch of orders by their internal ID or unique property values. It requires authentication via OAuth and the 'crm.objects.orders.read' scope. The request can include properties with history, a unique property name, and a list of order IDs. The response includes details about the orders, such as creation and update timestamps, properties, and archival status. The API supports filtering by archived status through a query parameter. The response can return multiple statuses, including successful operations and errors with detailed context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Postal Mail by Internal ID or Unique Property Values
ID
: post_read_batch_postal_mailOperation
: readEntities
: property, postal mail, errorSummary
: This API endpoint allows you to read a batch of postal mail records by their internal ID or unique property values. It requires the 'crm.objects.contacts.read' scope and adheres to standard API rate limits. The request can include optional query parameters such as 'archived' to filter archived results. The body can include 'propertiesWithHistory', 'idProperty', 'inputs', and 'properties' to specify the data to be retrieved. The response includes timestamps for the request, start, and completion of the operation, links, results with detailed properties, and the status of the operation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Subscriptions by Internal ID or Unique Property Values
ID
: post_read_batch_subscriptionsOperation
: readEntities
: property, error, subscriptionSummary
: This API endpoint allows you to read a batch of subscriptions by their internal ID or unique property values. It requires the 'crm.objects.subscriptions.read' scope and adheres to standard API rate limits. The request can include properties with history, a unique ID property, and an array of inputs specifying subscription IDs. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as detailed information about each subscription, including its properties and history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Tasks by Internal ID or Unique Property Values
ID
: post_read_batch_tasksOperation
: readEntities
: property, task, errorSummary
: This API endpoint allows you to read a batch of tasks by their internal ID or unique property values. It requires authorization via a Bearer token and supports OAuth. The request can include properties with history, a unique ID property, and an array of inputs specifying task IDs. The response includes timestamps for completion, request, and start, links, task results with properties and history, and the status of the request. The API supports filtering by archived status and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Read a Batch of Tickets by Internal ID or Unique Property Values
ID
: post_read_batch_ticketsOperation
: readEntities
: property, ticket, errorSummary
: This API endpoint allows you to read a batch of tickets by their internal ID or unique property values. It requires authentication via a Bearer token and supports OAuth. The request can include properties with history, a unique ID property, and a list of inputs containing ticket IDs. The 'archived' query parameter can be used to filter results based on their archived status. The response includes timestamps for when the operation was requested, started, and completed, as well as links, results with ticket details, and the operation status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Register Calling App for Recording
ID
: post_register_calling_app_for_recordingOperation
: writeEntities
: error, recording, appSummary
: This API endpoint registers a calling extension app with an external URL that HubSpot will use to retrieve call recordings. It requires the app ID as a path parameter and the developer API key as a query parameter. The request body must include the 'urlToRetrieveAuthedRecording', which is the URL HubSpot will use to access the recordings. The response will confirm the URL or provide detailed error information if the request fails.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Calls in CRM
ID
: post_search_calls_in_crmOperation
: readEntities
: property, call, filter groupSummary
: The Search Calls in CRM API allows users to search for call records within the CRM system. It requires authorization via a Bearer token and accepts various optional parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The 'filterGroups' parameter can include multiple filters with properties like 'highValue', 'propertyName', 'values', 'value', and 'operator'. The API returns a response containing the total number of results, paging information, and a list of call results with details such as creation and update timestamps, properties, and archived status. In case of errors, the response includes detailed error information with categories, messages, and context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Carts in CRM
ID
: post_search_carts_in_crmOperation
: readEntities
: cart, property, filter groupSummary
: The Search Carts in CRM API allows users to search for carts within the CRM system using various filters and sorting options. The API requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of cart results with details like creation and update timestamps, properties, and history. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.carts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Commerce Payments
ID
: post_search_commerce_paymentsOperation
: readEntities
: property, commerce payment, filter groupSummary
: The Search Commerce Payments API allows users to search for commerce payment objects in the CRM. It requires authorization via a Bearer token and supports various query parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and a list of results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.commercepayments.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Communications in CRM
ID
: post_search_communications_in_crmOperation
: readEntities
: property, communication, filterSummary
: This API endpoint allows users to search for communications within the CRM. It requires authorization via a Bearer token and accepts various optional parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The 'filterGroups' parameter can include multiple filters with properties like 'highValue', 'propertyName', 'values', 'value', and 'operator'. The response includes the total number of results, paging information, and a list of communication objects with details such as creation and update timestamps, properties, and history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Companies in CRM
ID
: post_search_companies_in_crmOperation
: readEntities
: property, company, filterSummary
: This API endpoint allows you to search for companies in the CRM. It requires authentication via a Bearer token and supports various query parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of company results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.companies.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Contacts in CRM
ID
: post_search_contacts_in_crmOperation
: readEntities
: property, contact, filter groupSummary
: The Search Contacts in CRM API allows users to search for contacts within the CRM system using various filters and query parameters. The API requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of contact results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search CRM Notes
ID
: post_search_crm_notesOperation
: readEntities
: property, note, filterSummary
: The Search CRM Notes API allows users to search for notes within the CRM system. It requires authorization via a Bearer token and accepts various search parameters in the request body, such as query, limit, after, sorts, properties, and filterGroups. The response includes the total number of results, paging information, and an array of note results with details like creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search CRM Objects
ID
: post_search_crm_objectsOperation
: readEntities
: property, object, filterSummary
: The Search CRM Objects API allows you to search for CRM objects of a specified type using various filters and parameters. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The path parameter 'objectType' specifies the type of CRM object to search. The request body can include a search query, limit, paging cursor, sorting options, properties to include, and filter groups with specific filters. The response includes the total number of results, paging information, and an array of results with details such as creation and update timestamps, properties, and history. The API is exempt from the per-ten-second API call limit and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search CRM Tasks
ID
: post_search_crm_tasksOperation
: readEntities
: property, task, filterSummary
: The Search CRM Tasks API allows users to search for tasks within the CRM system. It requires authentication via a Bearer token and supports various query parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, pagination details, and an array of task objects with properties like 'createdAt', 'archived', 'propertiesWithHistory', and more. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search CRM Tickets
ID
: post_search_crm_ticketsOperation
: readEntities
: property, ticket, filter groupSummary
: The Search CRM Tickets API allows users to search for tickets within the CRM system using various filters and sorting options. The request requires authentication via a Bearer token and accepts parameters such as query, limit, after, sorts, properties, and filterGroups in the request body. The response includes the total number of results, paging information, and a list of ticket results with details such as creation and update timestamps, properties, and archived status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Deals in CRM
ID
: post_search_deals_in_crmOperation
: readEntities
: property, deal, filter groupSummary
: The Search Deals in CRM API allows users to search for deals within the CRM system using various parameters. The API requires authorization via a Bearer token and accepts a JSON body with optional parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of deal results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.deals.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Discounts in CRM
ID
: post_search_discounts_in_crmOperation
: readEntities
: discount, property, filter groupSummary
: The Search Discounts in CRM API allows users to search for discount objects within the CRM system. It requires authentication via a Bearer token and supports various query parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and a list of discount results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Emails in CRM
ID
: post_search_emails_in_crmOperation
: readEntities
: contact, emailSummary
: The Search Emails in CRM API allows users to search for emails within the CRM system using various filters and criteria. The API requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of email results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Feedback Submissions
ID
: post_search_feedback_submissionsOperation
: readEntities
: property, feedback submission, filter groupSummary
: The Search Feedback Submissions API allows users to search for feedback submissions in the CRM. It requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of feedback submission results with details like creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Fees in CRM
ID
: post_search_fees_in_crmOperation
: readEntities
: property, fee, filter groupSummary
: The Search Fees in CRM API allows users to search for fees within the CRM system using various filters and sorting options. The API requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and a list of results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Goal Targets
ID
: post_search_goal_targetsOperation
: readEntities
: property, goal target, filterSummary
: The Search Goal Targets API allows users to search for goal targets within the CRM. It requires authentication via a Bearer token and supports various search parameters such as query, limit, after, sorts, properties, and filterGroups. The response includes the total number of results, paging information, and a list of goal targets with their properties and history. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.goals.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Invoices in CRM
ID
: post_search_invoices_in_crmOperation
: readEntities
: property, invoice, filter groupSummary
: The Search Invoices in CRM API allows users to search for invoices within the CRM system using various filters and sorting options. The API requires an authorization header with a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of invoice results with details like creation and update timestamps, properties, and archived status.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Leads in CRM
ID
: post_search_leads_in_crmOperation
: readEntities
: lead, property, filter groupSummary
: The Search Leads in CRM API allows users to search for leads within the CRM system using various filters and criteria. The API requires authentication via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of lead results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.leads.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Line Items in CRM
ID
: post_search_line_items_in_crmOperation
: readEntities
: property, line item, filter groupSummary
: The 'Search Line Items in CRM' API allows users to search for line items within the CRM system. It requires authorization via a Bearer token and accepts various parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and a list of line items with their properties and history. The API is exempt from the per-ten-second API call limit and requires specific scopes for access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Lists by Name or Page Through All Lists
ID
: post_search_lists_by_name_or_page_through_all_listsOperation
: readEntities
: list, property, userSummary
: This API endpoint allows users to search for lists by name or page through all lists by providing an empty query value. It requires the 'crm.lists.read' scope and adheres to standard API rate limits. The request body can include parameters such as 'listIds' to filter by list ID, 'offset' for pagination, 'query' to search by list name, 'count' to specify the number of lists to return, 'processingTypes' to filter by processing type, 'additionalProperties' to include extra list properties, and 'sort' to determine the order of results. The response includes the total number of matching lists, an offset for pagination, and details of each list such as processing type, object type, and additional properties. If there are more results to page through, 'hasMore' will be true.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Meetings in CRM
ID
: post_search_meetings_in_crmOperation
: readEntities
: property, meeting, filterSummary
: This API endpoint allows you to search for meetings in the CRM system. It requires authorization via a Bearer token and accepts various optional parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The 'filterGroups' parameter can include multiple filters with properties like 'highValue', 'propertyName', 'values', 'value', and 'operator'. The response includes the total number of results, paging information, and a list of meeting results with details such as creation and update timestamps, archived status, and meeting properties. In case of errors, detailed error information is provided, including error category, message, and context.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Orders in CRM
ID
: post_search_orders_in_crmOperation
: readEntities
: property, order, filter groupSummary
: The Search Orders in CRM API allows users to search for orders within the CRM system using various parameters. The API requires authentication via a Bearer token and accepts a JSON body with optional parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of order results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.orders.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Postal Mail Objects in CRM
ID
: post_search_postal_mail_objectsOperation
: readEntities
: postal mail, filter group, sortSummary
: This API endpoint allows you to search for postal mail objects in the CRM. It requires authorization via a Bearer token and accepts various parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and an array of result objects with details like creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.contacts.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Products in CRM
ID
: post_search_products_in_crmOperation
: readEntities
: property, filter group, productSummary
: The Search Products in CRM API allows users to search for products within the CRM system using various filters and sorting options. The API requires authorization via a Bearer token and accepts a JSON body with parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, pagination details, and an array of product results with their properties and history. The API is exempt from the per-ten-second API call limit and requires the 'e-commerce' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Quotes in CRM
ID
: post_search_quotes_in_crmOperation
: readEntities
: property, quote, filterSummary
: The Search Quotes in CRM API allows users to search for quotes within the CRM system using various parameters. The request can include a search query, limit, pagination cursor, sorting criteria, properties to include, and filter groups. The response includes the total number of results, paging information, and a list of quote results with details such as creation and update timestamps, properties, and archived status. The API requires authorization via a Bearer token and is exempt from the per-ten-second API call limit.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Subscriptions in CRM
ID
: post_search_subscriptions_in_crmOperation
: readEntities
: property, subscription, filter groupSummary
: This API endpoint allows you to search for subscriptions within the CRM. It requires authorization via a Bearer token and accepts various parameters in the request body, such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The 'filterGroups' parameter can contain multiple filters with attributes like 'highValue', 'propertyName', 'values', 'value', and 'operator'. The response includes the total number of results, paging information, and a list of subscription results with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.subscriptions.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Search Taxes in CRM
ID
: post_search_taxes_in_crmOperation
: readEntities
: taxSummary
: The Search Taxes in CRM API allows users to search for tax objects within the CRM system. It requires authentication via a Bearer token and supports various query parameters such as 'query', 'limit', 'after', 'sorts', 'properties', and 'filterGroups'. The response includes the total number of results, paging information, and a list of tax objects with details such as creation and update timestamps, properties, and archived status. The API is exempt from the per-ten-second API call limit and requires the 'crm.objects.line_items.read' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Start a New Import
ID
: post_start_a_new_importOperation
: writeEntities
: import request, file, metadataSummary
: The 'Start a New Import' API begins importing data from specified file resources. It uploads the corresponding files and uses the import request object to convert rows in the files to objects. The API requires the 'crm.import' scope and adheres to standard API rate limits. The request body must include a list of files in binary format and a JSON formatted import request detailing metadata such as the import name and column mappings. The successful response includes details about the import, such as the import template, creation time, metadata counters, file IDs, object lists, import source, name, state, ID, opt-out status, and update time. Errors are detailed with specific categories, context, correlation ID, and links to documentation.Input Fields
: Input FieldsOutput Fields
: Output Fields
Start an Export of CRM Data
ID
: post_start_an_export_of_crm_dataOperation
: writeEntities
: CRM data, error, exportSummary
: This API endpoint starts an export of CRM data for the specified portal. It requires an authorization bearer token and a content-type header set to application/json. The request body must include details such as exportType, format, exportName, objectProperties, associatedObjectType, objectType, language, and publicCrmSearchRequest. The response returns a 202 status code with an ID of the export and related links. In case of errors, a detailed error message with context and links to documentation is provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Translate Legacy List Id to Modern List Id in Batch
ID
: post_translate_legacy_list_id_to_modern_list_id_in_batchOperation
: writeEntities
: listSummary
: This API translates a batch of legacy list IDs to modern list IDs, allowing for a maximum of 10,000 IDs per request. It requires the 'crm.lists.read' scope and adheres to standard API rate limits. The request must include headers for 'accept', 'content-type', and 'authorization', and the body should contain an array of legacy list IDs. The response provides a mapping of legacy list IDs to modern list IDs and lists any legacy IDs that could not be found. This API is temporary and will expire on May 30th, 2025.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Calls by Internal ID or Unique Property Values
ID
: post_update_batch_callsOperation
: writeEntities
: property, call, errorSummary
: This API endpoint allows you to update a batch of call objects in HubSpot by their internal ID or unique property values. The request requires authentication via a Bearer token and expects a JSON body containing an array of call objects to be updated. Each call object must specify an 'idProperty' and 'id', along with the properties to be updated. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of the updated call objects. The API supports OAuth and private apps, and requires the 'crm.objects.contacts.write' scope.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Communications by Internal ID or Unique Property Values
ID
: post_update_batch_communicationsOperation
: writeEntities
: property, error, communicationSummary
: This API endpoint allows you to update a batch of communications by their internal ID or unique property values. It requires the 'crm.objects.contacts.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token and a content-type header set to 'application/json'. The body of the request should contain an array of objects, each specifying an 'idProperty' (the name of a unique property), an 'id' (either the object ID or the unique property value), and a 'properties' object with the properties to be updated. The response includes timestamps for when the request was completed, started, and requested, as well as links and results for each updated object. The results include details such as creation and update timestamps, archived status, and properties with history. The status of the operation is also provided.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Contacts by Internal ID or Unique Property Values
ID
: post_update_batch_contactsOperation
: writeEntities
: property, contact, errorSummary
: This API endpoint allows you to update a batch of contacts in HubSpot by their internal ID or unique property values. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request should contain an array of contact objects, each with an idProperty, id, and properties to be updated. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of the updated contacts. The API requires the 'crm.objects.contacts.write' scope and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of CRM Objects
ID
: post_update_batch_crm_objectsOperation
: writeEntities
: property, scope, objectSummary
: This API endpoint allows you to update a batch of CRM objects by their internal ID or unique property values. You need to provide the object type as a path parameter and an array of objects to update in the request body. Each object in the array should include the unique property name, the ID or unique property value, and the properties to update. The response includes timestamps for when the operation was requested, started, and completed, as well as the results of the update operation, including the updated properties and their history.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Discounts by Internal ID or Unique Property Values
ID
: post_update_batch_discountsOperation
: writeEntities
: discount, error, propertySummary
: This API endpoint allows you to update a batch of discounts by their internal ID or unique property values. It requires authorization via a Bearer token and accepts a JSON body containing an array of discount objects to update. Each object must specify an 'idProperty' and 'id', along with the properties to update. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each updated discount. The API supports standard and granular scopes for e-commerce and CRM objects line items write access.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Emails by Internal ID or Unique Property Values
ID
: post_update_batch_emailsOperation
: writeEntities
: property, email, errorSummary
: This API endpoint allows you to update a batch of emails by their internal ID or unique property values. It requires authentication via a Bearer token and accepts a JSON body containing an array of email objects to update. Each email object must specify an 'idProperty' and 'id', along with the properties to update. The response includes timestamps for when the operation was requested, started, and completed, as well as the status of the operation and details of each email updated. The API supports standard and granular scopes and adheres to standard API rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Line Items by Internal ID or Unique Property Values
ID
: post_update_batch_line_itemsOperation
: writeEntities
: property, line item, errorSummary
: This API endpoint allows you to update a batch of line items in the CRM by using either their internal ID or unique property values. The request requires authorization via a Bearer token and must include a JSON body with an array of line items to update. Each line item must specify an 'idProperty' and 'id', along with the properties to update. The response provides timestamps for the request, start, and completion of the operation, along with the status and details of each updated line item. The API supports standard and granular scopes for e-commerce and CRM line item writing.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Meetings by Internal ID or Unique Property Values
ID
: post_update_batch_meetingsOperation
: writeEntities
: property, meeting, errorSummary
: This API endpoint allows you to update a batch of meetings by their internal ID or unique property values. It requires authentication via OAuth and the 'crm.objects.contacts.write' scope. The request body must include an array of meeting objects, each with an 'idProperty', 'id', and 'properties' to be updated. The response includes timestamps for when the request was made, started, and completed, as well as the status of the operation and details of each meeting updated. The API adheres to standard rate limits.Input Fields
: Input FieldsOutput Fields
: Output Fields
Update a Batch of Notes by Internal ID or Unique Property Values
ID
: post_update_batch_notesOperation
: writeEntities
: property, error, note