Version 1.0
Connector Overview: This page documents all 263 actions for the Hubspotcrmconnector v1.0.
Basic (92)
DELETE Archive
/crm/v3/objects/carts/{cartId}
Move an Object identified by {cartId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/commerce_payments/{commercePaymentId}
Move an Object identified by {commercePaymentId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/companies/{companyId}
Move an Object identified by {companyId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the company to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/contacts/{contactId}
Move an Object identified by {contactId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the contact to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/{objectType}/{objectId}
Move an Object identified by {objectId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to archive, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/deals/{dealId}
Move an Object identified by {dealId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the deal to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/discounts/{discountId}
Move an Object identified by {discountId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the discount to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/feedback_submissions/{feedbackSubmissionId}
Move an Object identified by {feedbackSubmissionId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the feedback submission to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/fees/{feeId}
Move an Object identified by {feeId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the fee to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/leads/{leadsId}
Move an Object identified by {leadsId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/line_items/{lineItemId}
Move an Object identified by {lineItemId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the line item to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/orders/{orderId}
Move an Object identified by {orderId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/products/{productId}
Move an Object identified by {productId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the product to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/quotes/{quoteId}
Move an Object identified by {quoteId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the quote to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/taxes/{taxId}
Move an Object identified by {taxId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the tax to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Archive
/crm/v3/objects/tickets/{ticketId}
Move an Object identified by {ticketId} to the recycling bin.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the ticket to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create
/crm/v3/objects/carts
Create a cart with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard carts is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create
/crm/v3/objects/{objectType}
Create a CRM object with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard objects is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Create
/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}
Set association labels between two records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
The type of the target object, such as 'contact' or 'deal'. |
|
|
The unique identifier of the target object to associate. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The category of the association, for example 'HUBSPOT_DEFINED' or 'USER_DEFINED'. |
|
|
The numeric identifier for the specific association type within the given category. |
PUT Create Default
/crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/default/{toObjectType}/{toObjectId}
Create the default (most generic) association type between two object types
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The unique identifier of the source object from which the association originates. |
|
|
The type of the target object to associate with the source. |
|
|
The unique identifier of the target object to associate. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create1
/crm/v3/objects/commerce_payments
Create a commerce payment with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard commerce payments is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create10
/crm/v3/objects/orders
Create a order with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard orders is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create11
/crm/v3/objects/products
Create a product with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard products is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create12
/crm/v3/objects/quotes
Create a quote with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard quotes is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create13
/crm/v3/objects/taxes
Create a tax with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard taxes is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create14
/crm/v3/objects/tickets
Create a ticket with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard tickets is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create2
/crm/v3/objects/companies
Create a company with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard companies is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create3
/crm/v3/objects/contacts
Create a contact with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard contacts is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create4
/crm/v3/objects/deals
Create a deal with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard deals is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create5
/crm/v3/objects/discounts
Create a discount with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard discounts is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create6
/crm/v3/objects/feedback_submissions
Create a feedback submission with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard feedback submissions is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create7
/crm/v3/objects/fees
Create a fee with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard fees is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create8
/crm/v3/objects/leads
Create a lead with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard leads is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create9
/crm/v3/objects/line_items
Create a line item with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard line items is provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Delete
/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}
deletes all associations between two records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
The type of the target object whose association is being removed. |
|
|
The unique identifier of the target object to disassociate. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List
/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}
List all associations of an object by object type. Limit 500 per call.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
The maximum number of results to display per page. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List
/crm/v3/objects/carts
Read a page of carts. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List
/crm/v3/objects/{objectType}
Read a page of objects. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List1
/crm/v3/objects/commerce_payments
Read a page of commerce payments. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List10
/crm/v3/objects/leads
Read a page of leads. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List11
/crm/v3/objects/line_items
Read a page of line items. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List12
/crm/v3/objects/orders
Read a page of orders. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List13
/crm/v3/objects/payments
Read a page of payments. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List14
/crm/v3/objects/products
Read a page of products. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List15
/crm/v3/objects/quotes
Read a page of quotes. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List16
/crm/v3/objects/taxes
Read a page of taxes. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List17
/crm/v3/objects/tickets
Read a page of tickets. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List18
/crm/v3/objects/invoices
Read a page of invoices. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List2
/crm/v3/objects/subscriptions
Read a page of subscriptions. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List3
/crm/v3/objects/companies
Read a page of companies. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List4
/crm/v3/objects/contacts
Read a page of contacts. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List5
/crm/v3/objects/deals
Read a page of deals. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List6
/crm/v3/objects/discounts
Read a page of discounts. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List7
/crm/v3/objects/feedback_submissions
Read a page of feedback submissions. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List8
/crm/v3/objects/fees
Read a page of fees. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET List9
/crm/v3/objects/goal_targets
Read a page of goal targets. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The maximum number of results to display per page. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of objects that can be read by a single request. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/carts/{cartId}
Read an Object identified by {cartId}. {cartId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/commerce_payments/{commercePaymentId}
Read a payment identified by its ID. Include an optional properties query parameter to control the properties that are returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested payment, they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested payment, they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/subscriptions/{subscriptionId}
Read an Object identified by {subscriptionId}. {subscriptionId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/companies/{companyId}
Read an Object identified by {companyId}. {companyId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the company to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/contacts/{contactId}
Read an Object identified by {contactId}. {contactId} refers to the internal object ID. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The unique identifier of the contact to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/{objectType}/{objectId}
Read an Object identified by {objectId}. {objectId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/deals/{dealId}
Read an Object identified by {dealId}. {dealId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the deal to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/discounts/{discountId}
Read an Object identified by {discountId}. {discountId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the discount to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/feedback_submissions/{feedbackSubmissionId}
Read an Object identified by {feedbackSubmissionId}. {feedbackSubmissionId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the feedback submission to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/fees/{feeId}
Read an Object identified by {feeId}. {feeId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the fee to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/goal_targets/{goalTargetId}
Read an Object identified by {goalTargetId}. {goalTargetId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the goal target to read. Provide the ID as a string. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/leads/{leadsId}
Read an Object identified by {leadsId}. {leadsId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/line_items/{lineItemId}
Read an Object identified by {lineItemId}. {lineItemId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the line item to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/orders/{orderId}
Read an Object identified by {orderId}. {orderId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/payments/{paymentsId}
Read an Object identified by {paymentsId}. {paymentsId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/products/{productId}
Read an Object identified by {productId}. {productId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the product to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/quotes/{quoteId}
Read an Object identified by {quoteId}. {quoteId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the quote to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/taxes/{taxId}
Read an Object identified by {taxId}. {taxId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the tax to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/tickets/{ticketId}
Read an Object identified by {ticketId}. {ticketId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the ticket to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v3/objects/invoices/{invoiceId}
Read an Object identified by {invoiceId}. {invoiceId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Control what is returned via the properties query param.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
|
|
A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
|
|
Whether to return only results that have been archived. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/carts/{cartId}
Perform a partial update of an Object identified by {cartId}. {cartId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/commerce_payments/{commercePaymentId}
Perform a partial update of an Object identified by {commercePaymentId}. {commercePaymentId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/companies/{companyId}
Perform a partial update of an Object identified by {companyId}. {companyId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the company to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/contacts/{contactId}
Perform a partial update of an Object identified by {contactId}. {contactId} refers to the internal object ID. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The unique identifier of the contact to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/{objectType}/{objectId}
Perform a partial update of an Object identified by {objectId}. {objectId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
The unique identifier of the object to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/deals/{dealId}
Perform a partial update of an Object identified by {dealId}. {dealId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the deal to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/discounts/{discountId}
Perform a partial update of an Object identified by {discountId}. {discountId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the discount to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/feedback_submissions/{feedbackSubmissionId}
Perform a partial update of an Object identified by {feedbackSubmissionId}. {feedbackSubmissionId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the feedback submission to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/fees/{feeId}
Perform a partial update of an Object identified by {feeId}. {feeId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the fee to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/leads/{leadsId}
Perform a partial update of an Object identified by {leadsId}. {leadsId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/line_items/{lineItemId}
Perform a partial update of an Object identified by {lineItemId}. {lineItemId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the line item to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/orders/{orderId}
Perform a partial update of an Object identified by {orderId}. {orderId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/products/{productId}
Perform a partial update of an Object identified by {productId}. {productId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the product to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/quotes/{quoteId}
Perform a partial update of an Object identified by {quoteId}. {quoteId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the quote to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/taxes/{taxId}
Perform a partial update of an Object identified by {taxId}. {taxId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the tax to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update
/crm/v3/objects/tickets/{ticketId}
Perform a partial update of an Object identified by {ticketId}. {ticketId} refers to the internal object ID by default, or optionally any unique property value as specified by the idProperty query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name of a property whose values are unique for this object type |
|
|
The unique identifier of the ticket to archive. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Batch (78)
POST Archive a batch of associations
/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/archive
Remove the associations between all pairs of objects identified in the request body.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of carts by ID
/crm/v3/objects/carts/batch/archive
Archive multiple carts at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of commerce payments by ID
/crm/v3/objects/commerce_payments/batch/archive
Archive multiple commerce payments at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of companies by ID
/crm/v3/objects/companies/batch/archive
Archive multiple companies at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of contacts by ID
/crm/v3/objects/contacts/batch/archive
Archive multiple contacts at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of deals by ID
/crm/v3/objects/deals/batch/archive
Archive multiple deals at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of discounts by ID
/crm/v3/objects/discounts/batch/archive
Archive multiple discounts at once by providing their unique identifiers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of feedback submissions by ID
/crm/v3/objects/feedback_submissions/batch/archive
Archive multiple feedback submissions at once by providing their IDs. Use this to remove outdated or irrelevant feedback in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of fees by ID
/crm/v3/objects/fees/batch/archive
Archive multiple fees at once by providing their IDs. Use this to remove outdated or incorrect fee records in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of leads by ID
/crm/v3/objects/leads/batch/archive
Archive multiple leads at once by providing their IDs. Use this to remove outdated or unqualified leads in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of line items by ID
/crm/v3/objects/line_items/batch/archive
Archive multiple line items at once by providing their IDs. Use this to remove obsolete or incorrect line items in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of objects by ID
/crm/v3/objects/{objectType}/batch/archive
Archive multiple objects of a specific type at once by providing their IDs. Use this for bulk removal of any object type supported by the endpoint.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of orders by ID
/crm/v3/objects/orders/batch/archive
Archive multiple orders at once by providing their IDs. Use this to remove outdated or canceled orders in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of products by ID
/crm/v3/objects/products/batch/archive
Archive multiple products at once by providing their IDs. Use this to remove outdated or discontinued products in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of quotes by ID
/crm/v3/objects/quotes/batch/archive
Archive multiple quotes at once by providing their IDs. Use this to remove expired or declined quotes in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of taxes by ID
/crm/v3/objects/taxes/batch/archive
Archive multiple taxes at once by providing their IDs. Use this to remove outdated or incorrect tax records in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Archive a batch of tickets by ID
/crm/v3/objects/tickets/batch/archive
Archive multiple tickets at once by providing their IDs. Use this to remove closed or irrelevant tickets in bulk.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create
/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/create
Batch create associations for objects
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create Default Associations
/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/associate/default
Create the default (most generic) association type between two object types
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of associations
/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/create
Associate all pairs of objects identified in the request body.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of carts
/crm/v3/objects/carts/batch/create
Create multiple carts in a single request. Use this to add several carts at once, each with its own set of properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of commerce payments
/crm/v3/objects/commerce_payments/batch/create
Create multiple commerce payments in a single request. Use this to add several payment records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of companies
/crm/v3/objects/companies/batch/create
Create multiple companies in a single request. Use this to add several company records at once with their properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of contacts
/crm/v3/objects/contacts/batch/create
Create multiple contacts in a single request. Use this to add several contact records at once with their properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of deals
/crm/v3/objects/deals/batch/create
Create multiple deals in a single request. Use this to add several deal records at once with their properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of discounts
/crm/v3/objects/discounts/batch/create
Create multiple discounts in a single request. Use this to add several discount records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of feedback submissions
/crm/v3/objects/feedback_submissions/batch/create
Create multiple feedback submissions in a single request. Use this to add several feedback records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of fees
/crm/v3/objects/fees/batch/create
Create multiple fees in a single request. Use this to add several fee records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of leads
/crm/v3/objects/leads/batch/create
Create multiple leads in a single request. Use this to add several lead records at once with their properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of line items
/crm/v3/objects/line_items/batch/create
Create multiple line items in a single request. Use this to add several line item records at once with their properties.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of objects
/crm/v3/objects/{objectType}/batch/create
Create multiple objects of a specified type in a single request. Use this to efficiently add several records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of orders
/crm/v3/objects/orders/batch/create
Create multiple orders in a single request. Use this to efficiently add several order records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of products
/crm/v3/objects/products/batch/create
Create multiple products in a single request. Use this to efficiently add several product records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of quotes
/crm/v3/objects/quotes/batch/create
Create multiple quotes in a single request. Use this to efficiently add several quote records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of taxes
/crm/v3/objects/taxes/batch/create
Create multiple taxes in a single request. Use this to efficiently add several tax records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create a batch of tickets
/crm/v3/objects/tickets/batch/create
Create multiple tickets in a single request. Use this to efficiently add several ticket records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Create or replace deal splits for deals with the provided IDs. Deal split percentages for each deal must sum up to 1.0 (100%) and may have up to 8 decimal places
/crm/v3/objects/deals/splits/batch/upsert
Create or replace deal splits for the specified deals. Use this to set the percentage splits for each deal, ensuring the percentages sum to 1.0.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Delete
/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/archive
Batch delete associations for objects
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Delete Specific Labels
/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/labels/archive
Batch delete specific association labels for objects. Deleting an unlabeled association will also delete all labeled associations between those two objects
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Read
/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/read
Batch read associations for objects to specific object type. The 'after' field in a returned paging object can be added alongside the 'id' to retrieve the next page of associations from that objectId. The 'link' field is deprecated and should be ignored.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Read a batch of associations
/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/read
Get the IDs of all {toObjectType} objects associated with those specified in the request body.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Read a batch of carts by internal ID, or unique property values
/crm/v3/objects/carts/batch/read
Retrieve a batch of carts by their internal IDs or unique property values. Use this to fetch multiple cart records efficiently.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each cart. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying carts if not using internal IDs. |
POST Read a batch of commerce payments by internal ID, or unique property values
/crm/v3/objects/commerce_payments/batch/read
Retrieve a batch of commerce payments by their internal IDs or unique property values. Use this to fetch multiple payment records efficiently.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each payment. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying payments if not using internal IDs. |
POST Read a batch of companies by internal ID, or unique property values
/crm/v3/objects/companies/batch/read
Retrieve a batch of companies by their internal IDs or unique property values. Use this to fetch multiple company records efficiently.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each company. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying companies if not using internal IDs. |
POST Read a batch of contacts by internal ID, or unique property values
/crm/v3/objects/contacts/batch/read
Retrieve a batch of contacts by their internal IDs or unique property values. Use this to fetch multiple contact records efficiently.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of deal split objects by their associated deal object internal ID
/crm/v3/objects/deals/splits/batch/read
Retrieve a batch of deal split objects by their associated deal internal IDs. Use this to get the split details for multiple deals at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Read a batch of deals by internal ID, or unique property values
/crm/v3/objects/deals/batch/read
Read a batch of deals by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of discounts by internal ID, or unique property values
/crm/v3/objects/discounts/batch/read
Read a batch of discounts by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of feedback submissions by internal ID, or unique property values
/crm/v3/objects/feedback_submissions/batch/read
Read a batch of feedback submissions by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of fees by internal ID, or unique property values
/crm/v3/objects/fees/batch/read
Read a batch of fees by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of goal targets by internal ID, or unique property values
/crm/v3/objects/goal_targets/batch/read
Read a batch of goal targets by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of invoices by internal ID, or unique property values
/crm/v3/objects/invoices/batch/read
Read a batch of invoices by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of leads by internal ID, or unique property values
/crm/v3/objects/leads/batch/read
Read a batch of leads by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of line items by internal ID, or unique property values
/crm/v3/objects/line_items/batch/read
Read a batch of line items by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of objects by internal ID, or unique property values
/crm/v3/objects/{objectType}/batch/read
Read a batch of objects of a specified type by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of orders by internal ID, or unique property values
/crm/v3/objects/orders/batch/read
Read a batch of orders by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of payments by internal ID, or unique property values
/crm/v3/objects/payments/batch/read
Read a batch of payments by internal ID or unique property values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of products by internal ID, or unique property values
/crm/v3/objects/products/batch/read
Read a batch of products by their internal IDs or unique property values. Use this to efficiently retrieve multiple products in a single request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of quotes by internal ID, or unique property values
/crm/v3/objects/quotes/batch/read
Read a batch of quotes by their internal IDs or unique property values. Use this to efficiently retrieve multiple quotes in a single request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of subscriptions by internal ID, or unique property values
/crm/v3/objects/subscriptions/batch/read
Read a batch of subscriptions by their internal IDs or unique property values. Use this to efficiently retrieve multiple subscriptions in a single request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of taxes by internal ID, or unique property values
/crm/v3/objects/taxes/batch/read
Read a batch of taxes by their internal IDs or unique property values. Use this to efficiently retrieve multiple taxes in a single request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Read a batch of tickets by internal ID, or unique property values
/crm/v3/objects/tickets/batch/read
Read a batch of tickets by their internal IDs or unique property values. Use this to efficiently retrieve multiple tickets in a single request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
A list of property names to include in the response for each contact. |
|
|
A list of property names for which to return historical values. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST Update a batch of carts
/crm/v3/objects/carts/batch/update
Update a batch of carts with new property values. Use this to update multiple carts simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of commerce payments
/crm/v3/objects/commerce_payments/batch/update
Update a batch of commerce payments with new property values. Use this to update multiple commerce payments simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of companies by internal ID, or unique property values
/crm/v3/objects/companies/batch/update
Update a batch of companies by their internal IDs or unique property values. Use this to update multiple companies simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of contacts by internal ID, or unique property values
/crm/v3/objects/contacts/batch/update
Update a batch of contacts by their internal IDs or unique property values. Use this to update multiple contacts simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of deals by internal ID, or unique property values
/crm/v3/objects/deals/batch/update
Update a batch of deals by their internal IDs or unique property values. Use this to update multiple deals simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of discounts
/crm/v3/objects/discounts/batch/update
Update a batch of discounts with new property values. Use this to update multiple discounts simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of feedback submissions by internal ID, or unique property values
/crm/v3/objects/feedback_submissions/batch/update
Update a batch of feedback submissions by their internal IDs or unique property values. Use this to update multiple feedback submissions simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of fees
/crm/v3/objects/fees/batch/update
Update a batch of fees with new property values. Use this to update multiple fees simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of leads
/crm/v3/objects/leads/batch/update
Update a batch of leads with new property values. Use this to update multiple leads simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of line items by internal ID, or unique property values
/crm/v3/objects/line_items/batch/update
Update a batch of line items by their internal IDs or unique property values. Use this to update multiple line items simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of objects
/crm/v3/objects/{objectType}/batch/update
Update a batch of objects of a specified object type by their internal IDs or unique property values. Use this to update multiple objects of the same type simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of orders
/crm/v3/objects/orders/batch/update
Update multiple orders in a single request. Use this to efficiently apply changes to several orders at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of products by internal ID, or unique property values
/crm/v3/objects/products/batch/update
Update multiple products by their internal IDs or unique property values. Ideal for bulk product updates.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of quotes by internal ID, or unique property values
/crm/v3/objects/quotes/batch/update
Update multiple quotes by their internal IDs or unique property values. Use when you need to modify several quotes simultaneously.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of taxes
/crm/v3/objects/taxes/batch/update
Update multiple tax objects in a batch. Suitable for applying changes to several tax records at once.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Update a batch of tickets by internal ID, or unique property values
/crm/v3/objects/tickets/batch/update
Update multiple tickets by their internal IDs or unique property values. Useful for bulk ticket modifications.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Cards (5)
POST Create a new card
/crm/v3/extensions/cards-dev/{appId}
Defines a new card that will become active on an account when this app is installed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the app to which the card will belong. Provide the app ID from your developer account. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The title of the card to be displayed. Enter a descriptive name for the card. |
DELETE Delete a card
/crm/v3/extensions/cards-dev/{appId}/{cardId}
Permanently deletes a card definition with the given ID. Once deleted, data fetch requests for this card will no longer be sent to your service. This can't be undone.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the app that owns the card. Specify the app ID from your developer account. |
|
|
The ID of the card to delete. Provide the unique identifier of the card you want to remove. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Get a card.
/crm/v3/extensions/cards-dev/{appId}/{cardId}
Returns the definition for a card with the given ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the app that owns the card. Enter the app ID from your developer account. |
|
|
The ID of the card to retrieve. Provide the unique identifier of the card you want to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Get all cards
/crm/v3/extensions/cards-dev/{appId}
Returns a list of cards for a given app.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the app whose cards you want to list. Specify the app ID from your developer account. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update a card
/crm/v3/extensions/cards-dev/{appId}/{cardId}
Update a card definition with new details.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the app that owns the card. Provide the app ID from your developer account. |
|
|
The ID of the card to update. Enter the unique identifier of the card you want to modify. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The new title for the card. Specify the updated display name. |
Core (5)
POST Cancel an active import
/crm/v3/imports/{importId}/cancel
This allows a developer to cancel an active import.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the import to cancel. Provide the unique identifier of the active import you want to stop. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Get active imports
/crm/v3/imports
Returns a paged list of active imports for this account.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
A cursor that specifies the point before which to retrieve imports. Use the before value from a previous response to paginate backwards. |
|
|
The maximum number of results to display per page. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Get the information on any import
/crm/v3/imports/{importId}
A complete summary of an import record, including any updates.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the import to retrieve details for. Provide the unique identifier of the import you want to inspect. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Start a new import
/crm/v3/imports
Begins importing data from the specified file resources. This uploads the corresponding file and uses the import request object to convert rows in the files to objects.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
A list of files containing the data to import |
|
|
JSON formatted metadata about the import. This includes a name for the import and the column mappings for each file. See the overview tab for more on the required format. |
POST Start an export
/crm/v3/exports/export/async
Begins exporting CRM data for the portal as specified in the request body
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (7)
|
Option Name |
Description |
|---|---|
|
|
A name for the export to help identify it. Enter a descriptive label. |
|
|
The type of export, such as 'contacts' or 'companies'. Specify the object type you want to export. |
|
|
The file format for the export, for example 'csv' or 'xlsx'. Choose the desired output format. |
|
|
The language to use for export headers and formatting. Provide a language code like 'en'. |
|
|
The list of property names to include in the export. Provide an array of property names as strings. |
|
|
The object type to export, such as 'contacts' or 'deals'. Specify which type of records to export. |
|
|
An optional associated object type to include related data. Provide the object type that is associated with the primary export object. |
Definitions (4)
POST Create
/crm/v4/associations/{fromObjectType}/{toObjectType}/labels
Create a user defined association definition
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The display name for the forward association label. |
|
|
The internal name used to identify the label programmatically. |
|
|
The display name for the inverse (reverse) association label. |
DELETE Delete
/crm/v4/associations/{fromObjectType}/{toObjectType}/labels/{associationTypeId}
Deletes an association definition
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read
/crm/v4/associations/{fromObjectType}/{toObjectType}/labels
Returns all association types between two object types
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update
/crm/v4/associations/{fromObjectType}/{toObjectType}/labels
Update a user defined association definition
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The numeric ID of the association type to update. |
|
|
The new display name for the forward association label. |
|
|
The new display name for the inverse association label. |
Delete
POST post-/feature-flags/v3/{app Id}/flags/{flag Name}/portals/batch/delete
/feature-flags/v3/{appId}/flags/{flagName}/portals/batch/delete
Remove a list of portal IDs from a feature flag for an app.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
An array of portal IDs to be removed from the feature flag. |
GDPR (2)
POST GDPR DELETE
/crm/v3/objects/fees/gdpr-delete
Permanently delete a contact and all associated content to follow GDPR. Use optional property 'idProperty' set to 'email' to identify contact by email address. If email address is not found, the email address will be added to a blocklist and prevent it from being used in the future.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the fee object to be GDPR-deleted. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
POST GDPR DELETE1
/crm/v3/objects/taxes/gdpr-delete
Permanently delete a contact and all associated content to follow GDPR. Use optional property 'idProperty' set to 'email' to identify contact by email address. If email address is not found, the email address will be added to a blocklist and prevent it from being used in the future.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the tax object to be GDPR-deleted. |
|
|
The name of the unique property to use for identifying contacts if not using internal IDs. |
Lists API (18)
POST Create List
/crm/v3/lists
Create a new list with the provided object list definition.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
The name to assign to the new list. |
|
|
The object type ID that the list will be based on. |
|
|
The processing type for the list, such as MANUAL or SNAPSHOT. |
|
|
The ID of the folder where the list should be placed. |
POST Creates a folder
/crm/v3/lists/folders
Creates a folder with the given information.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The name of the new folder. |
|
|
The ID of the parent folder under which to create this folder. |
DELETE Delete a List
/crm/v3/lists/{listId}
Delete a list by ILS list ID. Lists deleted through this endpoint can be restored up to 90-days following the delete. After 90-days, the list is purged and can no longer be restored.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to delete. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
DELETE Deletes a folder
/crm/v3/lists/folders/{folderId}
Deletes the folder with the given Id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Fetch List Memberships Ordered by Added to List Date
/crm/v3/lists/{listId}/memberships/join-order
Fetch the memberships of a list in order sorted by the time the records were added to the list.
The recordIds are sorted in ascending order if an after offset or no offset is provided. If only a before offset is provided, then the records are sorted in descending order.
The after offset parameter will take precedence over the before offset in a case where both are provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The paging offset token for the page that comes after the previously requested records. If provided, then the records in the response will be the records following the offset, sorted in ascending order. Takes precedence over the before offset. |
|
|
The paging offset token for the page that comes before the previously requested records. If provided, then the records in the response will be the records preceding the offset, sorted in descending order. |
|
|
The number of records to return in the response. The maximum limit is 250. |
|
|
(Required) The ILS ID of the list. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Fetch List by ID
/crm/v3/lists/{listId}
Fetch a single list by ILS list ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A flag indicating whether or not the response object list definition should include a filter branch definition. By default, object list definitions will not have their filter branch definitions included in the response. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Fetch List by Name
/crm/v3/lists/object-type-id/{objectTypeId}/name/{listName}
Fetch a single list by list name and object type.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A flag indicating whether or not the response object list definition should include a filter branch definition. By default, object list definitions will not have their filter branch definitions included in the response. |
|
|
The object type ID that the list belongs to. |
|
|
The name of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Fetch Multiple Lists
/crm/v3/lists
Fetch multiple lists in a single request by ILS list ID. The response will include the definitions of all lists that exist for the listIds provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ILS IDs of the lists to fetch. |
|
|
A flag indicating whether or not the response object list definitions should include a filter branch definition. By default, object list definitions will not have their filter branch definitions included in the response. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Get lists record is member of
/crm/v3/lists/records/{objectTypeId}/{recordId}/memberships
For given record provide lists this record is member of.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) Object type id of the record |
|
|
(Required) Id of the record |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Moves a folder
/crm/v3/lists/folders/{folderId}/move/{newParentFolderId}
This moves the folder from its current location to a new location. It updates the parent of this folder to the new Id given.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Moves a list to a given folder
/crm/v3/lists/folders/move-list
Given a list and a folder, the list will be moved to that folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the list to be moved to a new folder. |
|
|
The ID of the destination folder where the list should be placed. |
PUT Rename a folder
/crm/v3/lists/folders/{folderId}/rename
Renames the given folderId with a new name.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The new name to assign to the folder. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Restore a List
/crm/v3/lists/{listId}/restore
Restore a previously deleted list by ILS list ID. Deleted lists are eligible to be restored up-to 90-days after the list has been deleted.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Retrieves a folder.
/crm/v3/lists/folders
Retrieves a folder and recursively includes all folders via the childNodes attribute. The child lists field will be empty in all child nodes. Only the folder retrieved will include the child lists in that folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The Id of the folder to retrieve. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Translate Legacy List Id to Modern List Id
/crm/v3/lists/idmapping
This API allows translation of legacy list id to list id. This is a temporary API allowed for mapping old id's to new id's and will expire on May 30th, 2025.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The legacy list id from lists v1 API. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST Translate Legacy List Id to Modern List Id in Batch
/crm/v3/lists/idmapping
This API allows translation of a batch of legacy list id's to list id's. This allows for a maximum of 10,000 id's. This is a temporary API allowed for mapping old id's to new id's and will expire on May 30th, 2025.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
An array of objects containing legacy list IDs to be translated to modern IDs. |
PUT Update List Filter Definition
/crm/v3/lists/{listId}/update-list-filters
Update the filter branch definition of a DYNAMIC list. Once updated, the list memberships will be re-evaluated and updated to match the new definition.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
A flag indicating whether or not the memberships added to the list as a result of the filter change should be enrolled in workflows that are relevant to this list. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update List Name
/crm/v3/lists/{listId}/update-list-name
Update the name of a list. The name must be globally unique relative to all other public lists in the portal.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The name to update the list to. |
|
|
A flag indicating whether or not the response object list definition should include a filter branch definition. By default, object list definitions will not have their filter branch definitions included in the response. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Lists
POST Search Lists
/crm/v3/lists/search
Search lists by list name or page through all lists by providing an empty query value.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (6)
|
Option Name |
Description |
|---|---|
|
|
Additional search properties to filter results. |
|
|
The offset value for paginating through the search results. |
|
|
The search query string used to find matching lists. |
|
|
The number of results to return per page. |
|
|
An array of list IDs to restrict the search to specific lists. |
|
|
An array of processing types to filter lists by their processing mode. |
Memberships (6)
PUT Add All Records from a Source List to a Destination List
/crm/v3/lists/{listId}/memberships/add-from/{sourceListId}
Add all of the records from a source list (specified by the sourceListId) to a destination list (specified by the listId). Records that are already members of the destination list will be ignored. The destination and source list IDs must be different. The destination and source lists must contain records of the same type (e.g. contacts, companies, etc.).
This endpoint only works for destination lists that have a processingType of MANUAL or SNAPSHOT. The source list can have any processingType.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
The ID of the source list whose records will be added to the destination list. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Add Records to a List
/crm/v3/lists/{listId}/memberships/add
Add the records provided to the list. Records that do not exist or that are already members of the list are ignored.
This endpoint only works for lists that have a processingType of MANUAL or SNAPSHOT.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
An array of objects containing the record IDs to add to the list. |
PUT Add and/or Remove Records from a List
/crm/v3/lists/{listId}/memberships/add-and-remove
Add and/or remove records that have already been created in the system to and/or from a list.
This endpoint only works for lists that have a processingType of MANUAL or SNAPSHOT.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
An array of record IDs to be added to the list. |
|
|
An array of record IDs to be removed from the list. |
DELETE Delete All Records from a List
/crm/v3/lists/{listId}/memberships
Remove all of the records from a list. *Note: The list is not deleted.*
This endpoint only works for lists that have a processingType of MANUAL or SNAPSHOT.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Fetch List Memberships Ordered by ID
/crm/v3/lists/{listId}/memberships
Fetch the memberships of a list in order sorted by the recordId of the records in the list.
The recordIds are sorted in ascending order if an after offset or no offset is provided. If only a before offset is provided, then the records are sorted in descending order.
The after offset parameter will take precedence over the before offset in a case where both are provided.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The paging offset token for the page that comes after the previously requested records. If provided, then the records in the response will be the records following the offset, sorted in ascending order. Takes precedence over the before offset. |
|
|
The paging offset token for the page that comes before the previously requested records. If provided, then the records in the response will be the records preceding the offset, sorted in descending order. |
|
|
The number of records to return in the response. The maximum limit is 250. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Remove Records from a List
/crm/v3/lists/{listId}/memberships/remove
Remove the records provided from the list. Records that do not exist or that are not members of the list are ignored.
This endpoint only works for lists that have a processingType of MANUAL or SNAPSHOT.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the list to fetch. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
An array of objects containing the record IDs to add to the list. |
Owners (2)
GET Get a page of owners
/crm/v3/owners
Retrieve a paginated list of all owners in the HubSpot CRM. Use this action to fetch owner records for use in other operations.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Filter by email address (optional) |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
The maximum number of results to display per page. |
|
|
Whether to return only results that have been archived. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Read an owner by given `id` or `userId`
/crm/v3/owners/{ownerId}
Retrieve a specific owner record using its unique identifier. Use this to get details about a single owner.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the property type (e.g., 'id' or 'userId') to identify the owner when the ownerId parameter is ambiguous. |
|
|
Whether to return only results that have been archived. |
|
|
The unique identifier of the owner to retrieve, either the internal ID or the user ID depending on the idProperty value. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Pipeline Audits
GET Return an audit of all changes to the pipeline
/crm/v3/pipelines/{objectType}/{pipelineId}/audit
Return a reverse chronological list of all mutations that have occurred on the pipeline identified by {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Pipeline Stages (6)
POST Create a pipeline stage
/crm/v3/pipelines/{objectType}/{pipelineId}/stages
Create a new stage associated with the pipeline identified by {pipelineId}. The entire stage object, including its unique ID, will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The order in which this stage appears relative to other stages in the pipeline, typically as a number. |
|
|
The new display name for the forward association label. |
DELETE Delete a pipeline stage
/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}
Delete the pipeline stage identified by {stageId} associated with the pipeline identified by {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Replace a pipeline stage
/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}
Replace all the properties of an existing pipeline stage with the values provided. The updated stage will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The new display order position for the stage within the pipeline. |
|
|
The new display name for the forward association label. |
GET Return a pipeline stage by ID
/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}
Return the stage identified by {stageId} associated with the pipeline identified by {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Return all stages of a pipeline
/crm/v3/pipelines/{objectType}/{pipelineId}/stages
Return all the stages associated with the pipeline identified by {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update a pipeline stage
/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}
Perform a partial update of the pipeline stage identified by {stageId} associated with the pipeline identified by {pipelineId}. Any properties not included in this update will keep their existing values. The updated stage will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
Set to 'true' to archive the stage, removing it from active use. |
|
|
The new display order position for the stage within the pipeline. |
|
|
The new display name for the forward association label. |
Pipelines API
GET Return an audit of all changes to the pipeline stage
/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId}/audit
Return a reverse chronological list of all mutations that have occurred on the pipeline stage identified by {stageId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Pipelines (6)
POST Create a pipeline
/crm/v3/pipelines/{objectType}
Create a new pipeline with the provided property values. The entire pipeline object, including its unique ID, will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The order in which this pipeline appears relative to other pipelines of the same object type. |
|
|
The new display name for the forward association label. |
DELETE Delete a pipeline
/crm/v3/pipelines/{objectType}/{pipelineId}
Delete the pipeline identified by {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
When set to 'true', the API checks for any references to this pipeline before deleting and returns an error if found. |
|
|
When set to 'true', the API checks for any deals or other records currently using stages in this pipeline before deletion. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT Replace a pipeline
/crm/v3/pipelines/{objectType}/{pipelineId}
Replace all the properties of an existing pipeline with the values provided. This will overwrite any existing pipeline stages. The updated pipeline will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
When set to 'true', the API checks for any references to this pipeline before applying the replacement and returns an error if found. |
|
|
When set to 'true', the API checks for any deals or other records currently using stages in this pipeline before replacing it. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The new display order position for the pipeline relative to other pipelines of the same object type. |
|
|
The new display name for the forward association label. |
GET Retrieve all pipelines
/crm/v3/pipelines/{objectType}
Return all pipelines for the object type specified by {objectType}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET Return a pipeline by ID
/crm/v3/pipelines/{objectType}/{pipelineId}
Return a single pipeline object identified by its unique {pipelineId}.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PATCH Update a pipeline
/crm/v3/pipelines/{objectType}/{pipelineId}
Perform a partial update of the pipeline identified by {pipelineId}. The updated pipeline will be returned in the response.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
When set to 'true', the API checks for any references to this pipeline before applying the replacement and returns an error if found. |
|
|
When set to 'true', the API checks for any deals or other records currently using stages in this pipeline before replacing it. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
Set to 'true' to archive the stage, removing it from active use. |
|
|
The new display order position for the pipeline relative to other pipelines of the same object type. |
|
|
The new display name for the forward association label. |
Portals
GET get-/feature-flags/v3/{app Id}/flags/{flag Name}/portals
/feature-flags/v3/{appId}/flags/{flagName}/portals
Retrieve portals that have a given feature flag enabled. Use this to see which portals are using a specific feature flag.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the portal to start from when paginating through results. |
|
|
The maximum number of portal results to return per page. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Public_Exports
GET get-/crm/v3/exports/export/async/tasks/{task Id}/status
/crm/v3/exports/export/async/tasks/{taskId}/status
Retrieve the current status of an asynchronous export task. Use this to check whether an export has completed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The ID of the export task whose status you want to check. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Public_Imports
GET get-/crm/v3/imports/{import Id}/errors get Errors
/crm/v3/imports/{importId}/errors
Retrieve error details for a specific import. Use this to diagnose why an import failed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
|
|
The maximum number of results to display per page. |
|
|
The ID of the import to retrieve details for. Provide the unique identifier of the import you want to inspect. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Public_Object (3)
POST Merge two fees with same type
/crm/v3/objects/fees/merge
Merge two fee objects of the same type into a single record. Use this to combine duplicate fee entries.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the fee object that will be merged into the primary object. |
|
|
The ID of the fee object that will remain after the merge. |
POST Merge two objects with same type
/crm/v3/objects/{objectType}/merge
Merge two objects of the same object type into a single record. Use this to combine duplicate objects of any type.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the object that will be merged into the primary object. |
|
|
The ID of the object that will remain after the merge. |
POST Merge two taxes with same type
/crm/v3/objects/taxes/merge
Merge two tax objects of the same type into a single record. Use this to combine duplicate tax entries.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The ID of the tax object that will be merged into the primary object. |
|
|
The ID of the tax object that will remain after the merge. |
SampleResponse
GET Get sample card detail response
/crm/v3/extensions/cards-dev/sample-response
Returns an example card detail response. This is the payload with displayed details for a card that will be shown to a user. An app should send this in response to the data fetch request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Search (20)
POST post-/crm/v3/objects/carts/search
/crm/v3/objects/carts/search
Search for cart objects using a query. Use this to find carts matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/commerce payments/search
/crm/v3/objects/commerce_payments/search
Search for commerce payment objects using a query. Use this to find payments matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/companies/search do Search
/crm/v3/objects/companies/search
Search for company objects using a query. Use this to find companies matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/contacts/search do Search
/crm/v3/objects/contacts/search
Search for contact objects using a query. Use this to find contacts matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/deals/search do Search
/crm/v3/objects/deals/search
Search for deal objects using a query. Use this to find deals matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/discounts/search
/crm/v3/objects/discounts/search
Search for discount records using a filter query. Returns a paginated list of discounts that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/feedback submissions/search do Search
/crm/v3/objects/feedback_submissions/search
Search for feedback submission records using a filter query. Returns a paginated list of feedback submissions that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/fees/search
/crm/v3/objects/fees/search
Search for fee records using a filter query. Returns a paginated list of fees that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/goal targets/search do Search
/crm/v3/objects/goal_targets/search
Search for goal target records using a filter query. Returns a paginated list of goal targets that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/invoices/search
/crm/v3/objects/invoices/search
Search for invoice records using a filter query. Returns a paginated list of invoices that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/leads/search
/crm/v3/objects/leads/search
Search for lead records using a filter query. Returns a paginated list of leads that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/line items/search do Search
/crm/v3/objects/line_items/search
Search for line item records using a filter query. Returns a paginated list of line items that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/orders/search
/crm/v3/objects/orders/search
Search for order records using a filter query. Returns a paginated list of orders that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/payments/search
/crm/v3/objects/payments/search
Search for payment records using a filter query. Returns a paginated list of payments that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/products/search do Search
/crm/v3/objects/products/search
Search for product records using a filter query. Returns a paginated list of products that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/quotes/search do Search
/crm/v3/objects/quotes/search
Search for quote records using a filter query. Returns a paginated list of quotes that match the specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/subscriptions/search
/crm/v3/objects/subscriptions/search
Search for subscriptions using filters and criteria. Returns a list of matching subscription records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/taxes/search
/crm/v3/objects/taxes/search
Search for taxes using filters and criteria. Returns a list of matching tax records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
POST post-/crm/v3/objects/tickets/search do Search
/crm/v3/objects/tickets/search
Search for tickets using filters and criteria. Returns a list of matching ticket records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Specify the Content-Type header for the batch update request. The expected value is 'application/json'. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
POST post-/crm/v3/objects/{object Type}/search
/crm/v3/objects/{objectType}/search
Search for any CRM object type by specifying the object type in the path. Returns a list of matching records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of object to create, for example "contacts" or "companies". |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
A pagination cursor to retrieve the next set of search results. |
|
|
The maximum number of search results to return. |
|
|
A list of property names to include in the response for each contact. |
|
|
An array of sort criteria to order the search results. |
|
|
The search query string used to find matching lists. |
Types
GET List association types
/crm/v3/associations/{fromObjectType}/{toObjectType}/types
List all the valid association types available between two object types
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
The type of the source object, such as 'contact' or 'company'. |
|
|
The type of the target object for which to list associations. |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Upsert
POST post-/feature-flags/v3/{app Id}/flags/{flag Name}/portals/batch/upsert
/feature-flags/v3/{appId}/flags/{flagName}/portals/batch/upsert
Upsert portal overrides for a feature flag in batch. Creates or updates portal-level flag states for the given app and flag.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
{flagName} (3)
DELETE delete-/feature-flags/v3/{app Id}/flags/{flag Name}
/feature-flags/v3/{appId}/flags/{flagName}
Permanently delete a specific feature flag by app ID and flag name.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET get-/feature-flags/v3/{app Id}/flags/{flag Name}
/feature-flags/v3/{appId}/flags/{flagName}
Retrieve details of a specific feature flag by app ID and flag name.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT put-/feature-flags/v3/{app Id}/flags/{flag Name}
/feature-flags/v3/{appId}/flags/{flagName}
Update the default state and optional override state for a feature flag. Use this to change flag behavior globally.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The new default state for the flag, either ENABLED or DISABLED. |
|
|
The new override state for the flag, either ENABLED, DISABLED, or NO_OVERRIDE. |
{portalId} (3)
DELETE delete-/feature-flags/v3/{app Id}/flags/{flag Name}/portals/{portal Id}
/feature-flags/v3/{appId}/flags/{flagName}/portals/{portalId}
Delete a portal-level override for a specific feature flag. Removes the custom state for the given portal.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
GET get-/feature-flags/v3/{app Id}/flags/{flag Name}/portals/{portal Id}
/feature-flags/v3/{appId}/flags/{flagName}/portals/{portalId}
Retrieve the portal-level flag state for a specific portal, app, and flag.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
PUT put-/feature-flags/v3/{app Id}/flags/{flag Name}/portals/{portal Id}
/feature-flags/v3/{appId}/flags/{flagName}/portals/{portalId}
Set or update the portal-level flag state for a specific portal, app, and flag.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
(Required) |
|
|
(Required) |
|
|
(Required) |
|
|
Specifies the content type the client expects in the response, such as "application/json". |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The desired flag state for this portal, either ENABLED or DISABLED. |