Hubspot API Integration Vol.1

These are the list of integration use cases supported by Knit for Hubspot API as part of the CRM category

Delete a Deal Object

ID: delete_a_deal_object
Operation: write
Entities: deal, error, object
Summary: This API endpoint deletes a deal object identified by the {dealId} and moves it to the recycling bin. It requires the 'crm.objects.deals.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token. The response will be HTTP 204 with no content if successful. In case of an error, a detailed error object is returned with information such as subCategory, context, correlationId, links, message, category, and errors array.
Input Fields: Input Fields
Output Fields: Output Fields

Delete a List by ILS List ID

ID: delete_a_list_by_ils_list_id
Operation: write
Entities: list, error
Summary: This API endpoint deletes a list by its ILS list ID. The list can be restored within 90 days of deletion. After 90 days, the list is permanently purged. The request requires an authorization header with a Bearer token and the listId as a path parameter. The response for a successful deletion is HTTP 204 with no content. 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 Fields
Output Fields: Output Fields

Delete a Pipeline

ID: delete_a_pipeline
Operation: write
Entities: deal, order, pipeline
Summary: This API deletes a pipeline identified by the pipelineId for a specified objectType. It requires authentication via a Bearer token. The API accepts path parameters for objectType and pipelineId, and optional query parameters to validate references and deal stage usages before deletion. The response is a 204 No Content on success, and an error object on failure, which includes details such as subCategory, context, correlationId, links, message, category, and errors array.
Input Fields: Input Fields
Output Fields: Output Fields

Delete a Schema

ID: delete_a_schema
Operation: delete
Entities: record, schema
Summary: The 'Delete a Schema' API endpoint allows you to delete a schema from the system. Before calling this API, ensure that any existing records of this schema are deleted, otherwise the call will fail. The API requires the fully qualified name or object type ID of the schema as a path parameter. It also accepts an optional query parameter 'archived' to specify whether to return only results that have been archived, with a default value of false. The response body is typically empty for a successful DELETE request.
Input Fields: Input Fields
Output Fields: Output Fields

Delete All Records from a List

ID: delete_all_records_from_a_list
Operation: write
Entities: list, membership, error
Summary: This API endpoint deletes all records from a specified list in the CRM. It does not delete the list itself, only the memberships within it. The endpoint is applicable only for lists with a processingType of MANUAL or SNAPSHOT and supports lists with fewer than 100,000 memberships. The request requires an authorization header with a Bearer token and a path parameter 'listId' which is the ILS ID of the list. The response is a 204 No Content status if successful. 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 Fields
Output Fields: Output Fields

Archive Meeting Object

ID: delete_archive_meeting_object
Operation: write
Entities: meeting, error, context
Summary: The Archive Meeting Object API allows you to move a meeting object identified by the meetingId to the recycling bin. 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 the meetingId as a path parameter. A successful request returns a 204 No Content response. In case of errors, the response includes details such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Archive Note by ID

ID: delete_archive_note_by_id
Operation: write
Entities: error, note, context
Summary: This API endpoint archives a note identified by the {noteId} parameter by moving it to the recycling bin. It requires the 'crm.objects.contacts.write' scope for authorization. The request must include a valid Bearer token in the authorization header. The endpoint responds with a 204 No Content status on success. In case of errors, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Archive a Property

ID: delete_archive_property
Operation: write
Entities: property, error, objectType
Summary: The 'Archive a Property' API endpoint allows users to move a property identified by {propertyName} to the recycling bin. It requires the 'authorization' header with a Bearer token for authentication. The path parameters include 'objectType', which specifies the type of object the property belongs to, and 'propertyName', which is the name of the property to be archived. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and errors array with specific details about the error.
Input Fields: Input Fields
Output Fields: Output Fields

Archive a Property Group

ID: delete_archive_property_group
Operation: delete
Entities: property group, error, object type
Summary: This API endpoint is used to archive a property group identified by {groupName} by moving it to the recycling bin. It requires the objectType and groupName as path parameters. The request must include an authorization header with a Bearer token. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and errors array with specific error details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Association Definition

ID: delete_association_definition
Operation: delete
Entities: label, association, object type
Summary: This API deletes an association definition between two object types in the CRM. It requires the path parameters 'fromObjectType', 'toObjectType', and 'associationTypeId' to specify the association to be deleted. The request must include an 'authorization' header with a valid Bearer token. The API adheres to standard API rate limits and requires specific scopes for access. Upon successful deletion, the response body is empty.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Associations Between Two Records

ID: delete_associations_between_two_records
Operation: write
Entities: association, object, record
Summary: This API deletes all associations between two records specified by their object types and IDs. It requires authentication via a Bearer token. The path parameters include 'objectType', 'objectId', 'toObjectType', and 'toObjectId', which are all required. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Call Object

ID: delete_call_object
Operation: write
Entities: recycling bin, call, error
Summary: The Delete Call Object API moves a call object identified by the callId path parameter to the recycling bin. 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. A successful request returns a 204 No Content response. In case of errors, the response includes details such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Calling Extension Settings

ID: delete_calling_extension_settings
Operation: write
Entities: account, setting, app
Summary: The Delete Calling Extension Settings API endpoint allows you to delete a calling extension. This will remove your service as an option for all connected accounts. The request requires the 'appId' as a path parameter, which is the ID of the app. The API key must be provided in the headers as 'hapikey'. The response will be HTTP 204 No Content if successful. In case of an error, the response will include details such as 'subCategory', 'context', 'correlationId', 'links', 'message', 'category', and 'errors' with specific error details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Card Definition

ID: delete_card_definition
Operation: write
Entities: error, app, card
Summary: This API permanently deletes a card definition with the given card ID from the specified app ID. Once deleted, data fetch requests for this card will no longer be sent to your service. This action cannot be undone. The API requires the HubSpot developer API key as a header for authentication. The path parameters include 'appId' which is the ID of the target app, and 'cardId' which is the ID of the card to delete. The response for a successful deletion is HTTP 204 No Content. In case of errors, the response includes details such as subCategory, context, correlationId, links, message, category, and an array of errors with detailed information.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Cart Object

ID: delete_cart_object
Operation: write
Entities: cart, error, context
Summary: The Delete Cart Object API moves a cart object identified by the {cartId} path parameter to the recycling bin. It requires the 'crm.objects.carts.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token. A successful request returns a 204 No Content status. In case of errors, the response includes details such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Communication Object

ID: delete_communication_object
Operation: write
Entities: error, communication, context
Summary: This API endpoint is used to move a communication object identified by {communicationId} to the recycling bin. It requires the 'crm.objects.contacts.write' scope and adheres to standard API rate limits. The request must include the 'authorization' header with a valid Bearer token. The path parameter 'communicationId' is required to specify the communication object to be archived. A successful request returns a 204 No Content response. In case of an error, the response includes details such as subCategory, context, correlationId, links, message, category, and errors array with specific error details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Company Object

ID: delete_company_object
Operation: write
Entities: company, error, context
Summary: This API endpoint is used to move a company object identified by {companyId} to the recycling bin. 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. The path parameter 'companyId' is required to specify the company to be archived. A successful request returns a 204 No Content response. In case of errors, the response includes detailed error information such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Contact by ID

ID: delete_contact_by_id
Operation: write
Entities: recycling bin, contact, error
Summary: This API endpoint deletes a contact identified by the {contactId} from the CRM system and moves it to the recycling bin. It requires the 'crm.objects.contacts.write' scope for authorization. The request must include a valid Bearer token in the authorization header. The contactId is a required path parameter. On successful deletion, the API 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 Fields
Output Fields: Output Fields

Delete CRM Folder

ID: delete_crm_folder
Operation: write
Entities: error, folder
Summary: This API endpoint deletes a folder in the CRM system using the specified folder ID. It requires the 'crm.lists.write' and 'crm.lists.read' scopes for authorization. The request must include the 'accept' and 'authorization' headers. The response will return an error object if the deletion fails, detailing the error category, message, and any missing scopes or invalid properties.
Input Fields: Input Fields
Output Fields: Output Fields

Delete CRM Object

ID: delete_crm_object
Operation: write
Entities: object
Summary: This API endpoint allows you to delete a CRM object identified by {objectId} and move it to the recycling bin. It requires authentication via a Bearer token. The path parameters include 'objectType' which specifies the type of the object, and 'objectId' which specifies the ID of the object to be deleted. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete CRM Object Schema

ID: delete_crm_object_schema
Operation: delete
Entities: schema, object type
Summary: The Delete CRM Object Schema API allows you to permanently delete a CRM object schema identified by the 'objectType' path parameter. This API does not require any specific scopes and is subject to standard API rate limits. The request is made using the DELETE method to the endpoint '/crm-object-schemas/v3/schemas/{objectType}/purge'. The 'objectType' path parameter is required and specifies the type of the object schema to be purged. The response body is typically empty upon a successful deletion.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Discount Object

ID: delete_discount_object
Operation: write
Entities: discount, error, context
Summary: This API endpoint is used to move a discount object identified by {discountId} to the recycling bin. It requires an authorization header with a Bearer token for authentication. The {discountId} is a path parameter that specifies the discount object to be archived. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Email Object

ID: delete_email_object
Operation: write
Entities: email, error, context
Summary: This API endpoint deletes an email object identified by the {emailId} and moves it to the recycling bin. It requires authorization via a Bearer token. The request must include the emailId as a path parameter. On success, it returns a 204 No Content status. If there is an error, the response will include details about the error, such as a message, category, and context.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Event Template for App

ID: delete_event_template_for_app
Operation: write
Entities: event template, event
Summary: This API deletes an event template for a specified app. It requires the app ID and event template ID as path parameters. The API key must be provided in the headers. Upon successful deletion, all associated events will be removed from search results and the timeline UI. This action is irreversible, so it is recommended to stop using any associated events before deletion. The API returns a 204 No Content response on success. In case of errors, it provides detailed error information including subCategory, context, correlationId, links, message, category, and errors array.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Fee Object

ID: delete_fee_object
Operation: write
Entities: fee, error, object
Summary: The Delete Fee Object API moves a fee object identified by the {feeId} path parameter to the recycling bin. It requires an authorization header with a Bearer token. The API responds with a 204 No Content status on success. In case of errors, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Lead Object

ID: delete_lead_object
Operation: write
Entities: lead, error
Summary: This API endpoint is used to move a lead object identified by {leadsId} to the recycling bin. 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. The path parameter 'leadsId' is required to specify the lead to be archived. A successful request returns a 204 No Content response. In case of errors, the response includes detailed error information such as subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Line Item

ID: delete_line_item
Operation: write
Entities: line item, error
Summary: The Delete Line Item API moves a line item identified by the {lineItemId} to the recycling bin. It requires an authorization header with a Bearer token for authentication. The lineItemId is a required path parameter that specifies the ID of the line item to be archived. The API returns a 204 No Content response on success. In case of an error, it returns a detailed error object containing information such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Order Object

ID: delete_order_object
Operation: write
Entities: order, link, error
Summary: The Delete Order Object API allows you to move an order object identified by {orderId} to the recycling bin. It requires the 'crm.objects.orders.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token. The path parameter 'orderId' is required to specify the order to be archived. A successful request returns a 204 No Content response. In case of errors, the response includes detailed error information such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete a Pipeline Stage

ID: delete_pipeline_stage
Operation: write
Entities: error, stage, pipeline
Summary: This API deletes a pipeline stage identified by {stageId} associated with the pipeline identified by {pipelineId}. It requires authentication via a Bearer token. The path parameters include objectType, pipelineId, and stageId, all of which are required. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Postal Mail Object

ID: delete_postal_mail_object
Operation: write
Entities: postal mail, error, context
Summary: This API endpoint is used to move a postal mail object identified by the {postalMailId} to the recycling bin. 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. The path parameter 'postalMailId' is required to specify the object to be archived. 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 Fields
Output Fields: Output Fields

Delete Product and Move to Recycling Bin

ID: delete_product_and_move_to_recycling_bin
Operation: write
Entities: error, product
Summary: This API endpoint allows you to delete a product identified by the {productId} and move it to the recycling bin. It requires an authorization header with a Bearer token. The path parameter 'productId' is required to specify which product to archive. On success, it returns a 204 No Content response. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and errors array with specific details about the error.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Quote Object

ID: delete_quote_object
Operation: write
Entities: quote, error, authentication
Summary: The Delete Quote Object API allows you to move a quote object identified by {quoteId} to the recycling bin. It requires an authorization header with a Bearer token. The path parameter 'quoteId' is required to specify the quote to be deleted. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Remove an Association from a Schema

ID: delete_remove_association_from_schema
Operation: write
Entities: association, schema
Summary: The 'Remove an Association from a Schema' API endpoint allows users to delete an existing association from a specified schema. The request requires two path parameters: 'objectType', which is the fully qualified name or object type ID of the schema, and 'associationIdentifier', which is the unique ID of the association to be removed. The API does not require any specific headers, query parameters, or request body. Upon successful execution, the association will be removed, and the response will not contain any body content.
Input Fields: Input Fields
Output Fields: Output Fields

Remove Token from Event Template

ID: delete_remove_token_from_event_template
Operation: write
Entities: token, app, event template
Summary: This API endpoint removes a token from an existing event template in the HubSpot integrators timeline. It requires the app ID, event template ID, and token name as path parameters. Once a token is removed, existing events and CRM objects will retain the token and its mapped object properties, but new ones will not. The timeline will still display this property for older CRM objects if it's still referenced in the template Markdown. The API returns a 204 No Content response on success. In case of errors, it provides detailed error information including a unique correlation ID, error category, and human-readable messages.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Task Object

ID: delete_task_object
Operation: write
Entities: task, error, context
Summary: The Delete Task Object API moves a task object identified by the {taskId} to the recycling bin. 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. The path parameter 'taskId' is required to specify the task to be deleted. A successful request returns a 204 No Content response. In case of errors, the response includes detailed error information such as subCategory, context, correlationId, links, message, category, and an array of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Tax Object

ID: delete_tax_object
Operation: write
Entities: tax
Summary: The Delete Tax Object API endpoint allows you to move a tax object identified by {taxId} to the recycling bin. It requires the 'crm.objects.line_items.write' scope and adheres to standard API rate limits. The request must include an authorization header with a Bearer token. The path parameter 'taxId' is required to specify the tax object to be deleted. A successful request returns a 204 No Content response. In case of errors, the response includes detailed error information such as subCategory, context, correlationId, links, message, category, and errors array.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Ticket and Move to Recycling Bin

ID: delete_ticket_and_move_to_recycling_bin
Operation: write
Entities: link, error, ticket
Summary: This API endpoint allows you to delete a ticket identified by {ticketId} and move it to the recycling bin. It requires an authorization header with a Bearer token. The path parameter 'ticketId' is required to specify which ticket to delete. The API returns a 204 No Content response on success. In case of an error, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Delete Video Conference Application Settings

ID: delete_video_conference_application_settings
Operation: write
Entities: setting, error, video conference application
Summary: This API deletes the settings for a video conference application with the specified ID. It requires the 'appId' as a path parameter, which is the identifier of the application created in your HubSpot developer portal. The request must include the HubSpot developer API key in the headers for authentication. The API returns a 204 No Content response on successful deletion. In case of errors, it provides detailed error information including subCategory, context, correlationId, links, message, category, and a list of errors with specific details.
Input Fields: Input Fields
Output Fields: Output Fields

Get a Page of CRM Owners

ID: get_a_page_of_crm_owners
Operation: read
Entities: team, owner
Summary: This API endpoint retrieves a page of CRM owners. It supports filtering by email, pagination using a cursor token, and limiting the number of results per page. The response includes details about each owner, such as their name, email, creation and update timestamps, and team affiliations. The API requires an authorization bearer token and supports optional query parameters for filtering and pagination.
Input Fields: Input Fields
Output Fields: Output Fields

Get Active Imports

ID: get_active_imports
Operation: read
Entities: account, import, error
Summary: The 'Get Active Imports' API endpoint retrieves a paged list of active imports for a HubSpot account. It requires an authorization header with a Bearer token. The API supports query parameters such as 'after', 'before', and 'limit' to manage pagination. The response includes details about each import, such as the import template, creation and update timestamps, metadata about the import process, and the state of the import. The API returns a 200 status code for successful operations and provides detailed error messages for validation errors.
Input Fields: Input Fields
Output Fields: Output Fields

Get All Cards for a Given App

ID: get_all_cards_for_a_given_app
Operation: read
Entities: display, fetch, card
Summary: This API endpoint retrieves a list of cards for a specified app using the app's ID. The request requires the appId as a path parameter and the HubSpot developer API key as a header. The response includes details about each card, such as its ID, creation and update timestamps, title, fetch configuration, display properties, and actions. The API does not require any specific scopes and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get All CRM Object Schemas

ID: get_all_crm_object_schemas
Operation: read
Entities: property, association, schema
Summary: This API endpoint retrieves all CRM object schemas defined for your account. It requires an authorization bearer token and supports an optional query parameter 'archived' to filter results based on their archived status. The response includes detailed information about each schema, such as associations, properties, labels, and metadata. The API returns a list of schemas with their unique IDs, names, and other attributes, allowing you to manage and understand the structure of your CRM data.
Input Fields: Input Fields
Output Fields: Output Fields

Retrieve All Pipelines for a Specified Object Type

ID: get_all_pipelines_for_object_type
Operation: read
Entities: metadata, pipeline stage, pipeline
Summary: This API endpoint retrieves all pipelines for a specified object type in HubSpot. The object type is specified as a path parameter. The API requires an authorization header with a Bearer token. The response includes details about each pipeline, such as creation date, archived status, display order, and stages within the pipeline. Each stage includes metadata, display order, permissions, label, and unique identifiers. The API supports various scopes for access control and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get All User Configurations

ID: get_all_user_configurations
Operation: read
Entities: user, configuration, portal
Summary: This API endpoint retrieves all user configurations available on a given portal. It requires an authorization header with a Bearer token. The response includes an array of configuration objects, each containing details such as userEnforcedMaxToObjectIds, typeId, label, and category. The API supports various scopes for access control and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get All User Configurations for a Portal

ID: get_all_user_configurations_for_a_portal
Operation: read
Entities: user configuration, portal, scope
Summary: This API endpoint retrieves all user configurations available on a given portal. It requires authentication via a Bearer token and supports various scopes for access. The response includes an array of configuration objects, each with properties such as 'userEnforcedMaxToObjectIds', 'typeId', 'label', and 'category'. In case of an error, a detailed error object is returned, which includes information such as 'subCategory', 'context', 'correlationId', 'links', 'message', and 'category'.
Input Fields: Input Fields
Output Fields: Output Fields

Get Association Types Between Object Types

ID: get_association_types_between_object_types
Operation: read
Entities: label, association type, object type
Summary: This API endpoint retrieves all association types between two specified object types in the CRM. It requires an authorization header with a bearer token. The path parameters 'fromObjectType' and 'toObjectType' specify the object types for which the association types are to be retrieved. The response includes an array of association types, each with a typeId, label, and category. In case of an error, detailed error information is provided, including a correlationId for support purposes.
Input Fields: Input Fields
Output Fields: Output Fields

Get Audit of Pipeline Stage Changes

ID: get_audit_of_pipeline_stage_changes
Operation: read
Entities: pipeline, stage, audit
Summary: This API endpoint returns an audit of all changes to a specified pipeline stage. It provides a reverse chronological list of all mutations that have occurred on the pipeline stage identified by the 'stageId'. The request requires an authorization header with a Bearer token and path parameters including 'objectType', 'pipelineId', and 'stageId'. The response includes details of each change such as the identifier, raw object data, user ID, portal ID, action, message, and timestamp.
Input Fields: Input Fields
Output Fields: Output Fields

Get Call Object Details

ID: get_call_object_details
Operation: read
Entities: property, association, call
Summary: This API endpoint retrieves details of a call object identified by the callId. The callId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties and propertiesWithHistory query parameters. It also supports retrieving associated object IDs using the associations query parameter. The archived query parameter can be used to filter archived results. The response includes details such as associations, creation and update timestamps, properties, and their history.
Input Fields: Input Fields
Output Fields: Output Fields

Get Calling Extension Settings

ID: get_calling_extension_settings
Operation: read
Entities: calling setting, error, extension
Summary: This API endpoint retrieves the calling extension settings configured for a specific app in HubSpot. It requires the app ID as a path parameter and the HubSpot developer API key as a query parameter. The response includes details such as the creation and update timestamps, compatibility with custom objects, readiness status, service name, iframe dimensions, and the URL for the calling UI. The API adheres to standard rate limits and does not require any specific scopes.
Input Fields: Input Fields
Output Fields: Output Fields

Get Card Definition by ID

ID: get_card_definition_by_id
Operation: read
Entities: error, app, card
Summary: This API endpoint retrieves the definition of a card by its ID. It requires the app ID and card ID as path parameters, and the HubSpot developer API key as a query parameter. The response includes details such as the creation and update timestamps, title, fetch configuration, display properties, and actions configuration of the card. The API adheres to standard rate limits and does not require any specific scopes.
Input Fields: Input Fields
Output Fields: Output Fields

Get Cart Details by Cart ID

ID: get_cart_details_by_cart_id
Operation: read
Entities: cart, association, property
Summary: This API endpoint retrieves the details of a cart identified by the {cartId}. The {cartId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows you to control the returned data via the properties query parameter, which is a list of properties to be included in the response. Additionally, you can request properties with their history, associated object types, and specify whether to include archived results. The response includes details such as the cart's properties, associations, creation and update timestamps, and archived status. The API requires an authorization header with a Bearer token and supports OAuth and private apps for authentication.
Input Fields: Input Fields
Output Fields: Output Fields

Get Commerce Payment Details

ID: get_commerce_payment_details
Operation: read
Entities: property, association, commerce payment
Summary: This API endpoint retrieves details of a commerce payment object identified by the {commercePaymentId}. The {commercePaymentId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties and propertiesWithHistory query parameters. Additionally, associated object types can be retrieved using the associations query parameter. The archived query parameter can be used to filter archived results. The response includes details such as associations, creation and update timestamps, properties, and their history.
Input Fields: Input Fields
Output Fields: Output Fields

Get Communication Details by ID

ID: get_communication_details_by_id
Operation: read
Entities: property, association, communication
Summary: This API endpoint retrieves details of a communication object identified by the communicationId. The communicationId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with the propertiesWithHistory parameter. Associations can be retrieved using the associations parameter. The archived parameter determines if only archived results are returned, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Company Details by ID

ID: get_company_details_by_id
Operation: read
Entities: property, association, company
Summary: This API endpoint retrieves details of a company identified by the {companyId}. The {companyId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can also return properties with their history using the propertiesWithHistory query parameter. Additionally, it can retrieve associated object IDs using the associations query parameter and filter archived results using the archived query parameter. The response includes details such as the company's properties, associations, creation and update timestamps, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Contact Details by Contact ID

ID: get_contact_details_by_contact_id
Operation: read
Entities: contact
Summary: This API endpoint retrieves the details of a contact identified by the contactId. The contactId is the internal object ID of the contact. The API allows you to specify which properties to return using the properties query parameter. You can also request properties with their history using the propertiesWithHistory parameter, and retrieve associated object IDs using the associations parameter. The archived parameter allows you to filter results to only include archived contacts. The response includes the contact's properties, associations, creation and update timestamps, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Read CRM Object by ID

ID: get_crm_object_by_id
Operation: read
Entities: property, association, object
Summary: This API endpoint allows you to read a CRM object identified by its objectId. The objectId can refer to the internal object ID or any unique property value specified by the idProperty query parameter. You can control the response by specifying which properties to return using the properties query parameter. The endpoint supports various scopes for access control and adheres to standard API rate limits. The response includes details about the object, its properties, associations, and timestamps for creation and updates.
Input Fields: Input Fields
Output Fields: Output Fields

Get Deal Details by Deal ID

ID: get_deal_details_by_deal_id
Operation: read
Entities: property, association, deal
Summary: This API endpoint retrieves details of a deal identified by the specified dealId. The dealId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can also return properties with their history using the propertiesWithHistory query parameter. Additionally, associated object types can be retrieved using the associations query parameter. The archived query parameter controls whether only archived results are returned, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Discount Details

ID: get_discount_details
Operation: read
Entities: discount, line item, property
Summary: This API endpoint retrieves details of a discount object identified by the {discountId}. The {discountId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. It also supports retrieving associated object IDs with the associations parameter and can filter archived results using the archived parameter. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Email Object Details

ID: get_email_object_details
Operation: read
Entities: property, association, email
Summary: This API endpoint retrieves details of an email object identified by the {emailId}. The {emailId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. Associations with other objects can be retrieved using the associations query parameter. The archived query parameter determines if only archived results are returned, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Event Detail Template Rendered

ID: get_event_detail_template_rendered
Operation: read
Entities: template, error, event
Summary: This API endpoint retrieves the detailTemplate as rendered for a specified event. It requires the eventTemplateId and eventId as path parameters. The API uses OAuth for authentication and requires specific scopes such as 'tickets' or 'timeline'. The response includes the rendered details in HTML format. If there are errors, the response will include detailed error information including missing scopes, invalid property names, and a correlation ID for support.
Input Fields: Input Fields
Output Fields: Output Fields

Get Event Details

ID: get_event_details
Operation: read
Entities: template, contact, event
Summary: This API endpoint retrieves the details of a previously created event using the event template ID and event ID. It requires authorization via a Bearer token. The response includes comprehensive details about the event, such as the event template ID, creation time, additional data, iframe details, domain, tokens, unique identifier, user token, email, CRM object ID, timestamp, and object type. The API requires specific scopes for access and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Existing CRM Object Schema

ID: get_existing_crm_object_schema
Operation: read
Entities: property, association, schema
Summary: This API retrieves an existing CRM object schema from HubSpot. It requires the 'crm.objects.custom.read' or 'crm.schemas.custom.read' scope for authorization. The request must include the 'authorization' header with a Bearer token and a path parameter 'objectType' which is the fully qualified name or object type ID of the schema. The response includes details about the object schema such as associations, properties, labels, and metadata. The response body provides comprehensive information about the schema, including its creation and update timestamps, properties, and associations.
Input Fields: Input Fields
Output Fields: Output Fields

Get Export Task Status

ID: get_export_task_status
Operation: read
Entities: task, error, export
Summary: This API endpoint retrieves the status of an export task identified by the taskId. It returns the status of the export, including the URL of the resulting file if the export status is COMPLETE. The request requires an authorization header with a Bearer token. The response includes details such as the result, timestamps for when the export was requested, started, and completed, the number of errors, and any related links. If there are errors, detailed information about each error is provided.
Input Fields: Input Fields
Output Fields: Output Fields

Get Fee Object Details

ID: get_fee_object_details
Operation: read
Entities: property, association, fee
Summary: This API endpoint retrieves details of a fee object identified by the {feeId}. The {feeId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties and propertiesWithHistory query parameters. It also supports retrieving associated object IDs using the associations query parameter. The archived query parameter can be used to filter archived results. The response includes details such as associations, creation and update timestamps, properties, and their history.
Input Fields: Input Fields
Output Fields: Output Fields

Get Feedback Submission Details

ID: get_feedback_submission_details
Operation: read
Entities: property, association, feedback submission
Summary: This API endpoint retrieves details of a feedback submission identified by the feedbackSubmissionId. The feedbackSubmissionId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows control over the returned data via query parameters such as properties, propertiesWithHistory, associations, archived, and idProperty. The response includes details like associations, creation and update timestamps, properties, and archived status. The API requires authorization via a Bearer token.
Input Fields: Input Fields
Output Fields: Output Fields

Get Feedback Submissions

ID: get_feedback_submissions
Operation: read
Entities: property, association, feedback submission
Summary: This API endpoint retrieves a page of feedback submissions from the CRM. It allows filtering and control over the returned data through various query parameters such as 'limit', 'after', 'properties', 'propertiesWithHistory', 'associations', and 'archived'. The 'limit' parameter controls the number of results per page, while 'after' is used for pagination. 'Properties' and 'propertiesWithHistory' allow specifying which properties to return, with the latter including historical values. 'Associations' retrieves associated object IDs, and 'archived' filters results based on their archived status. The response includes paging information and a list of feedback submissions with details like creation and update timestamps, properties, and associations.
Input Fields: Input Fields
Output Fields: Output Fields

Fetch List by ID

ID: get_fetch_list_by_id
Operation: read
Entities: list, filter branch, user
Summary: The Fetch List by ID API allows you to retrieve a single list by its ILS list ID. It requires the 'crm.lists.read' scope and adheres to standard API rate limits. The API takes a path parameter 'listId' which is the ILS ID of the list to fetch. Optionally, a query parameter 'includeFilters' can be set to true to include filter branch definitions in the response. The response includes detailed information about the list such as processing type, object type, creation and update timestamps, and filter branches. In case of errors, detailed error messages and context are provided.
Input Fields: Input Fields
Output Fields: Output Fields

Fetch List by Name

ID: get_fetch_list_by_name
Operation: read
Entities: list, filter branch, filter
Summary: The 'Fetch List by Name' API endpoint allows users to retrieve a single list by specifying the list name and object type ID. The endpoint requires authentication via a Bearer token and supports OAuth. The path parameters include 'objectTypeId' and 'listName', which are required to identify the list. An optional query parameter 'includeFilters' can be set to true to include filter branch definitions in the response. The response includes detailed information about the list, such as processing type, object type ID, list ID, creation and update timestamps, and filter branch details. The API adheres to standard rate limits and requires the 'crm.lists.read' scope.
Input Fields: Input Fields
Output Fields: Output Fields

Fetch List Memberships Ordered by ID

ID: get_fetch_list_memberships_ordered_by_id
Operation: read
Entities: list, membership, record
Summary: This API endpoint fetches the memberships of a list ordered by the recordId of the records in the list. The records are sorted in ascending order if an 'after' offset or no offset is provided. If only a 'before' offset is provided, the records are sorted in descending order. The 'after' offset takes precedence over the 'before' offset if both are provided. The API requires the 'listId' as a path parameter and supports optional query parameters 'after', 'before', and 'limit' to control pagination and the number of records returned. The response includes the total number of records, paging information, and a list of results with each record's ID and membership timestamp.
Input Fields: Input Fields
Output Fields: Output Fields

Fetch Multiple Lists by ILS List ID

ID: get_fetch_multiple_lists_by_ils_list_id
Operation: read
Entities: list, user, filter
Summary: This API endpoint allows you to fetch multiple lists by their ILS list IDs in a single request. The response includes the definitions of all lists that exist for the provided list IDs. You can optionally include filter branch definitions in the response by setting the 'includeFilters' query parameter to true. The request requires an authorization header with a Bearer token. The response contains detailed information about each list, including processing type, object type, creation and update timestamps, and filter branch details.
Input Fields: Input Fields
Output Fields: Output Fields

Retrieve Folder with Child Nodes

ID: get_folder_with_child_nodes
Operation: read
Entities: child list, child node, folder
Summary: This API retrieves a folder from the CRM system, including all its child folders recursively via the childNodes attribute. The child lists field will be empty in all child nodes, and only the folder retrieved will include the child lists in that folder. The request requires an authorization header with a Bearer token and accepts a query parameter 'folderId' to specify the folder to retrieve. The response includes details about the folder such as its creation and update timestamps, parent folder ID, child nodes, and user ID. In case of an error, a detailed error message is provided with information about missing scopes or invalid properties.
Input Fields: Input Fields
Output Fields: Output Fields

Read Goal Target Object

ID: get_goal_target_object
Operation: read
Entities: property, association, goal target
Summary: This API endpoint allows you to read a Goal Target object identified by the goalTargetId. The goalTargetId can be the internal object ID or any unique property value specified by the idProperty query parameter. You can control the response by specifying properties, propertiesWithHistory, and associations as query parameters. The archived query parameter allows you to filter for archived results. The response includes details about the object such as its properties, associations, creation and update timestamps, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Import Errors

ID: get_import_errors
Operation: read
Entities: import, error, source data
Summary: The Get Import Errors API retrieves errors associated with a specific import in HubSpot. It requires an import ID as a path parameter and supports optional query parameters for pagination, such as 'after' for the paging cursor token and 'limit' for the maximum number of results per page. The response includes a list of errors with details such as the error type, context, and source data. Authentication is required via a Bearer token.
Input Fields: Input Fields
Output Fields: Output Fields

Get Import Information

ID: get_import_information
Operation: read
Entities: metadata, import, error
Summary: This API endpoint retrieves detailed information about a specific import in HubSpot. It requires the import ID as a path parameter and an authorization bearer token in the headers. The response includes a comprehensive summary of the import record, such as the import template details, creation and update timestamps, metadata about the import process, the source and name of the import, its current state, and whether it is an opt-out import. The API is subject to standard rate limits and requires the 'crm.import' scope for access.
Input Fields: Input Fields
Output Fields: Output Fields

Get Invoice Details

ID: get_invoice_details
Operation: read
Entities: property, association, invoice
Summary: This API endpoint retrieves details of an invoice identified by the {invoiceId}. The {invoiceId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can also return properties with their history using the propertiesWithHistory query parameter. Associations can be retrieved using the associations query parameter. The archived query parameter determines if only archived results should be returned. The response includes details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Lead Details by ID

ID: get_lead_details_by_id
Operation: read
Entities: lead, association, property
Summary: This API endpoint retrieves details of a lead identified by the {leadsId}. The {leadsId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. It also supports retrieving associated object IDs with the associations parameter and can filter archived results using the archived parameter. The response includes lead details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Line Item Details

ID: get_line_item_details
Operation: read
Entities: property, association, line item
Summary: This API endpoint retrieves details of a line item identified by the lineItemId. The lineItemId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can also return properties with their history using the propertiesWithHistory parameter. Associations can be retrieved using the associations parameter. The archived parameter specifies whether to return only archived results, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

List All Associations of an Object by Object Type

ID: get_list_all_associations_of_an_object_by_object_type
Operation: read
Entities: type, association, object
Summary: This API endpoint retrieves a list of all associations for a specified object by its type. It requires the object type, object ID, and the type of the associated object as path parameters. The API supports pagination with a 'limit' query parameter (default 500) and an 'after' query parameter for cursor-based pagination. The response includes a list of associations with details such as type ID, label, and category, along with the ID of the associated object. The API requires authorization via a Bearer token and supports various scopes for access control.
Input Fields: Input Fields
Output Fields: Output Fields

List All Event Templates for an App

ID: get_list_all_event_templates_for_an_app
Operation: read
Entities: CRM object, token, event template
Summary: This API endpoint is used to list all event templates owned by a specific app in HubSpot. The request requires the app ID as a path parameter and the HubSpot developer API key as a header. The response includes a list of event templates, each with details such as template ID, object type, name, header template, detail template, creation and update timestamps, and associated tokens. Tokens include information like name, type, creation and update timestamps, label, object property name, and options. The API supports standard rate limits and does not require any specific scopes.
Input Fields: Input Fields
Output Fields: Output Fields

List Commerce Payments

ID: get_list_commerce_payments
Operation: read
Entities: property, association, commerce payment
Summary: This API endpoint retrieves a paginated list of commerce payments. The response can be controlled using query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, and 'properties' to specify which properties to return. The response includes details about each payment, such as its associations, creation and update timestamps, and properties. Authentication is required via a Bearer token. The API supports OAuth and private apps, and requires the 'crm.objects.commercepayments.read' scope.
Input Fields: Input Fields
Output Fields: Output Fields

List Line Items

ID: get_list_line_items
Operation: read
Entities: property, association, line item
Summary: This API endpoint retrieves a page of line items from the CRM. It allows control over the returned data via query parameters such as 'limit', 'after', 'properties', 'propertiesWithHistory', 'associations', and 'archived'. The 'limit' parameter specifies the maximum number of results per page, defaulting to 10. The 'after' parameter is used for pagination. 'Properties' and 'propertiesWithHistory' allow specifying which properties to return, with the latter including historical values. 'Associations' retrieves associated object IDs, and 'archived' filters for archived items. The response includes paging information and a list of line items with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Fetch List Memberships Ordered by Added to List Date

ID: get_list_memberships_ordered_by_added_date
Operation: read
Entities: list, membership, record
Summary: This API endpoint fetches the memberships of a list ordered by the time the records were added to the list. The records can be paginated using 'after' and 'before' query parameters. The 'after' parameter takes precedence if both 'after' and 'before' are provided. The 'limit' parameter specifies the number of records to return, with a default of 100 and a maximum of 250. The response includes the total number of records, paging information, and a list of results with each record's ID and membership timestamp.
Input Fields: Input Fields
Output Fields: Output Fields

Get Lists Record is Member Of

ID: get_lists_record_is_member_of
Operation: read
Entities: list, membership, record
Summary: This API endpoint retrieves the lists that a given record is a member of. It requires the object type ID and record ID as path parameters. The request must include an authorization header with a Bearer token. The response includes the total number of lists and details about each list, such as the list ID, version, and timestamps of when the record was added. The API requires the 'crm.lists.read' scope and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Meeting Details by Meeting ID

ID: get_meeting_details_by_meeting_id
Operation: read
Entities: property, association, meeting
Summary: This API endpoint retrieves details of a meeting object identified by the meetingId. The meetingId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can also return properties with their history using the propertiesWithHistory parameter. Additionally, associated object types can be retrieved using the associations parameter. The archived parameter determines if only archived results should be returned, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Read Note Object by ID

ID: get_note_object_by_id
Operation: read
Entities: property, association, note
Summary: This API endpoint allows you to read a Note object identified by {noteId}. The {noteId} can be the internal object ID or any unique property value specified by the idProperty query parameter. You can control the response by specifying which properties to return using the properties query parameter. Additionally, you can request properties with their history, associated object types, and whether to include archived results. The response includes details about the note's associations, properties, creation and update timestamps, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Read Order Object by ID

ID: get_order_object_by_id
Operation: read
Entities: property, association, order
Summary: This API endpoint retrieves an order object identified by the specified orderId. The orderId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows control over the returned data via the properties query parameter, which specifies a list of properties to be included in the response. Additionally, propertiesWithHistory can be used to retrieve properties along with their historical values, and associations can be used to retrieve associated object IDs. The archived query parameter determines whether to return only archived results, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Goal Targets

ID: get_page_of_goal_targets
Operation: read
Entities: property, association, goal target
Summary: This API endpoint allows you to read a page of goal targets from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of goal target objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Get Pipeline Audit

ID: get_pipeline_audit
Operation: read
Entities: mutation, pipeline, audit
Summary: The Get Pipeline Audit API returns a reverse chronological list of all mutations that have occurred on the specified pipeline. It requires the objectType and pipelineId as path parameters and an authorization header with a Bearer token. The response includes details of each change, such as the identifier, raw object data, user ID, portal ID, action, message, and timestamp. The API supports various scopes for access and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Pipeline by ID

ID: get_pipeline_by_id
Operation: read
Entities: stage, pipeline
Summary: This API endpoint retrieves a single pipeline object identified by its unique pipelineId. It requires authentication via a Bearer token. The request must include the objectType and pipelineId as path parameters. The response includes details about the pipeline such as its creation date, archived status, display order, stages, and labels. Each stage within the pipeline also includes metadata, display order, permissions, and other relevant details. The API supports various scopes for access control and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Pipeline Stage by ID

ID: get_pipeline_stage_by_id
Operation: read
Entities: error, stage, pipeline
Summary: This API endpoint retrieves a specific pipeline stage by its ID. It requires the object type, pipeline ID, and stage ID as path parameters. The request must include an authorization header with a Bearer token. The response includes details about the pipeline stage such as creation date, archived status, metadata, display order, permissions, label, unique ID, and last updated date. The API supports various scopes for access control and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Pipeline Stages

ID: get_pipeline_stages
Operation: read
Entities: error, stage, pipeline
Summary: This API endpoint retrieves all stages associated with a specified pipeline identified by the pipelineId. It requires an authorization bearer token and the objectType and pipelineId as path parameters. The response includes details about each stage, such as creation date, archived status, metadata, display order, permissions, label, unique ID, and last updated date. The API supports various scopes for access and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Get Postal Mail Object Details

ID: get_postal_mail_object_details
Operation: read
Entities: property, association, postal mail
Summary: This API endpoint retrieves details of a postal mail object identified by the postalMailId. The postalMailId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. Associations with other object types can be retrieved using the associations query parameter. The archived query parameter determines if only archived results are returned, with a default value of false. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Product Details by Product ID

ID: get_product_details_by_product_id
Operation: read
Entities: property, association, product
Summary: This API endpoint retrieves details of a product identified by the productId. The productId can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter, and can also return properties with their history using the propertiesWithHistory parameter. Associations with other objects can be retrieved using the associations parameter. The archived parameter specifies whether to return only archived results. The response includes details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Get Quote Details by Quote ID

ID: get_quote_details_by_quote_id
Operation: read
Entities: property, association, quote
Summary: This API endpoint retrieves details of a quote identified by the {quoteId}. The {quoteId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. It also supports retrieving associated object IDs with the associations parameter and can filter archived results using the archived parameter. The response includes details such as associations, creation and update timestamps, properties, and archival status.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Calls

ID: get_read_a_page_of_calls
Operation: read
Entities: property, association, call
Summary: This API endpoint allows you to read a page of call records from the CRM. You can control the data returned using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of call objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Carts

ID: get_read_a_page_of_carts
Operation: read
Entities: cart, association, property
Summary: This API endpoint allows you to read a page of carts from the CRM. You can control the results returned using various query parameters such as 'limit', 'after', 'properties', 'propertiesWithHistory', 'associations', and 'archived'. The 'limit' parameter specifies the maximum number of results per page, defaulting to 10. The 'after' parameter is used for pagination. The 'properties' and 'propertiesWithHistory' parameters allow you to specify which properties to return, with the latter also including historical values. The 'associations' parameter lets you retrieve associated object IDs. The 'archived' parameter filters results based on their archived status, defaulting to false. The response includes paging information and a list of cart objects with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Communications

ID: get_read_a_page_of_communications
Operation: read
Entities: property, association, communication
Summary: This API endpoint allows you to read a page of communications from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of communication objects with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Companies

ID: get_read_a_page_of_companies
Operation: read
Entities: property, association, company
Summary: This API endpoint retrieves a page of companies from the CRM. It allows for control over the returned data via query parameters such as 'limit', 'after', 'properties', 'propertiesWithHistory', 'associations', and 'archived'. The 'limit' parameter controls the number of results per page, defaulting to 10. The 'after' parameter is used for pagination. The 'properties' and 'propertiesWithHistory' parameters specify which properties to return, with the latter including historical values. The 'associations' parameter retrieves associated object IDs, and 'archived' filters for archived results. The response includes paging information and a list of company objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Contacts

ID: get_read_a_page_of_contacts
Operation: read
Entities: contact
Summary: This API endpoint allows you to read a page of contacts from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of contact objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of CRM Objects

ID: get_read_a_page_of_crm_objects
Operation: read
Entities: property, association, object
Summary: This API endpoint allows you to read a page of CRM objects from HubSpot. You can control the data returned by specifying various query parameters such as 'limit' for the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of results with details such as associations, creation and update timestamps, properties, and archived status.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Deals

ID: get_read_a_page_of_deals
Operation: read
Entities: property, association, deal
Summary: This API endpoint allows you to read a page of deals from the CRM. You can control the data returned by specifying query parameters such as 'limit' for the number of results per page, 'after' for pagination, 'properties' to specify which deal properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived deals. The response includes paging information and a list of deal objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Discounts

ID: get_read_a_page_of_discounts
Operation: read
Entities: discount, association, property
Summary: This API endpoint allows you to read a page of discounts from the CRM. You can control the data returned using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of discount objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Emails

ID: get_read_a_page_of_emails
Operation: read
Entities: property, association, email
Summary: This API endpoint allows you to read a page of emails from the CRM. You can control the results returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of email objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Fees

ID: get_read_a_page_of_fees
Operation: read
Entities: property, association, fee
Summary: This API endpoint allows you to read a page of fees from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of fee objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Invoices

ID: get_read_a_page_of_invoices
Operation: read
Entities: property, association, invoice
Summary: This API endpoint allows you to read a page of invoices from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of invoice objects with their properties, associations, and timestamps. The API requires an authorization header with a Bearer token.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Leads

ID: get_read_a_page_of_leads
Operation: read
Entities: lead, association, property
Summary: This API endpoint allows you to read a page of leads from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of lead objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Meetings

ID: get_read_a_page_of_meetings
Operation: read
Entities: property, association, meeting
Summary: This API endpoint allows you to read a page of meetings from the CRM. You can control the data returned using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of meeting objects with their properties, associations, and timestamps. The API requires an authorization header with a Bearer token and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Notes

ID: get_read_a_page_of_notes
Operation: read
Entities: property, association, note
Summary: This API endpoint allows you to read a page of notes from the CRM. You can control the data returned using various query parameters such as 'limit', 'after', 'properties', 'propertiesWithHistory', 'associations', and 'archived'. The 'limit' parameter specifies the maximum number of results per page, defaulting to 10. The 'after' parameter is used for pagination. The 'properties' and 'propertiesWithHistory' parameters allow you to specify which properties to return, with the latter also including historical values. The 'associations' parameter retrieves associated object IDs, and the 'archived' parameter filters results based on their archived status. The response includes paging information and a list of note objects with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Orders

ID: get_read_a_page_of_orders
Operation: read
Entities: property, association, order
Summary: This API endpoint allows you to read a page of orders from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of order objects with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Postal Mail

ID: get_read_a_page_of_postal_mail
Operation: read
Entities: property, association, postal mail
Summary: This API endpoint allows you to read a page of postal mail objects from the CRM. You can control the data returned by specifying query parameters such as 'limit' for the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of postal mail objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Products

ID: get_read_a_page_of_products
Operation: read
Entities: property, association, product
Summary: This API endpoint allows you to read a page of products from the CRM. You can control the results returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which product properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived products. The response includes paging information and a list of product results with details such as creation and update timestamps, properties, and associations.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Quotes

ID: get_read_a_page_of_quotes
Operation: read
Entities: property, association, quote
Summary: This API endpoint allows you to read a page of quotes from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of quote objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Subscriptions

ID: get_read_a_page_of_subscriptions
Operation: read
Entities: property, association, subscription
Summary: This API endpoint allows you to read a page of subscriptions from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of subscription objects with their details.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Tasks

ID: get_read_a_page_of_tasks
Operation: read
Entities: property, association, task
Summary: This API endpoint allows you to read a page of tasks from the CRM. You can control the results returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include property history, 'associations' to retrieve associated object IDs, and 'archived' to filter archived tasks. The response includes paging information and a list of task objects with their properties, associations, and timestamps. The API requires an authorization header with a Bearer token and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Taxes

ID: get_read_a_page_of_taxes
Operation: read
Entities: property, tax, association
Summary: This API endpoint allows you to read a page of taxes from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values, 'associations' to retrieve associated object IDs, and 'archived' to filter archived results. The response includes paging information and a list of tax objects with their properties, associations, and history if requested.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Page of Tickets

ID: get_read_a_page_of_tickets
Operation: read
Entities: property, association, ticket
Summary: This API endpoint allows you to read a page of tickets from the CRM. You can control the data returned by using various query parameters such as 'limit' to specify the number of results per page, 'after' for pagination, 'properties' to specify which properties to return, 'propertiesWithHistory' to include historical values of properties, 'associations' to retrieve associated object IDs, and 'archived' to filter archived tickets. The response includes paging information and a list of ticket objects with their properties, associations, and timestamps.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Property

ID: get_read_a_property
Operation: read
Entities: property, metadata, option
Summary: This API endpoint allows you to read a property identified by {propertyName} for a specified {objectType} in HubSpot. It requires authentication via a Bearer token and supports various scopes for access. The endpoint accepts path parameters for objectType and propertyName, and optional query parameters such as archived and properties. The response includes detailed information about the property, including its creation and update metadata, display settings, and options. The API adheres to standard rate limits and provides detailed error messages in case of validation errors.
Input Fields: Input Fields
Output Fields: Output Fields

Read a Property Group

ID: get_read_a_property_group
Operation: read
Entities: property, error, property group
Summary: This API endpoint allows you to read a property group identified by {groupName} for a specified {objectType}. It requires an authorization header with a Bearer token. The response includes details about the property group such as whether it is archived, its internal name, display order, and label. The API requires specific scopes for access and adheres to standard API rate limits. In case of errors, detailed error information is provided including subcategories, context, and links to documentation.
Input Fields: Input Fields
Output Fields: Output Fields

Read All Properties for Specified Object Type in HubSpot

ID: get_read_all_properties_for_specified_object_type
Operation: read
Entities: property, option, modification metadata
Summary: This API endpoint allows you to read all existing properties for a specified object type in a HubSpot account. It requires authentication via a Bearer token and supports both private apps and OAuth. The endpoint accepts a path parameter 'objectType' to specify the type of object for which properties are being requested. It also supports query parameters such as 'archived' to filter archived properties and 'properties' to specify a list of property names to include in the response. The response includes detailed information about each property, such as its creation and update metadata, visibility, data type, and options. The API requires specific scopes for access and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Read All Property Groups for Specified Object Type

ID: get_read_all_property_groups
Operation: read
Entities: object type, property group, HubSpot account
Summary: This API endpoint allows you to read all existing property groups for a specified object type in a HubSpot account. It requires an authorization header with a Bearer token. The path parameter 'objectType' specifies the type of object for which property groups are being retrieved. The response includes an array of property groups, each with details such as whether it is archived, its internal name, display order, and label. The API requires specific scopes for access, and adheres to standard API rate limits.
Input Fields: Input Fields
Output Fields: Output Fields

Read Calling App Recording Settings

ID: get_read_calling_app_recording_settings
Operation: read
Entities: recording, error, setting
Summary: This API retrieves the recording endpoint configured for a calling extension app in HubSpot. It requires the app ID as a path parameter and the HubSpot developer API key as a query parameter. The response includes the URL to retrieve the authenticated recording. In case of an error, detailed error information is provided, including a unique correlation ID, error category, and context.
Input Fields: Input Fields
Output Fields: Output Fields

Read an Owner by Given ID or UserID

ID: get_read_owner_by_id_or_userid
Operation: read
Entities: team, error, owner
Summary: This API endpoint retrieves an owner by a given ID or userId. It requires the 'crm.objects.owners.read' scope for authentication. The request must include the 'authorization' header with a Bearer token. The 'ownerId' path parameter is required to specify the owner to retrieve. Optional query parameters include 'idProperty' to specify the property for ID lookup (default is 'id') and 'archived' to filter archived results (default is false). The response includes details about the owner such as first name, last name, email, and associated teams. In case of an error, a detailed error message is provided.
Input Fields: Input Fields
Output Fields: Output Fields

Render Event Template as HTML

ID: get_render_event_template_as_html
Operation: read
Entities: template, event template, event
Summary: This API endpoint renders either the header or detail of an event template as HTML. It requires the eventTemplateId and eventId as path parameters. Optionally, a query parameter 'detail' can be set to 'true' to render the detailTemplate instead of the headerTemplate. The request must include an 'accept' header set to 'text/html' and an 'authorization' header with a valid Bearer token. The response will be the rendered HTML content. If there are any errors, a detailed error message will be provided in the response.
Input Fields: Input Fields
Output Fields: Output Fields

Get Sample Card Detail Response

ID: get_sample_card_detail_response
Operation: read
Entities: section, action, card detail
Summary: The 'Get Sample Card Detail Response' API endpoint provides an example card detail response. This response is used to display card details to a user. The API does not require authentication and adheres to standard API rate limits. The response includes details such as the total count of card properties, a URL for more items, card labels, top-level actions, and sections with tokens and actions. The response is structured to include settings for IFRAME types, action hooks, and confirmation prompts. The API returns a successful operation with a 200 status code and provides detailed error information in case of validation errors.
Input Fields: Input Fields
Output Fields: Output Fields

Get Specific Event Template for an App

ID: get_specific_event_template_for_an_app
Operation: read
Entities: CRM object, token, event template
Summary: This API endpoint retrieves a specific event template for a given app using the app ID and event template ID as path parameters. The response includes details about th