HubSpot: Fees schemas
35 HubSpot schemas with complete fields and constraints.
← Fees operations · All schemas
Archive batch objects — fees batch Delete Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot. |
inputs | array | Required within parent | An array of SimplePublicObjectId objects, each containing an ID of a simple public object to be processed in the batch operation. |
inputs[] | Model | Each item | Expand Archive a batch of contacts — request body — body inputs item |
Referenced models: Archive a batch of contacts — request body — body inputs item
Batch create objects — fees batch Create Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a batch input for creating multiple simple public objects in a single request. This component is used to streamline the process of adding new objects to a HubSpot account by allowing multiple entries to be created at once. |
inputs | array | Required within parent | An array of objects to be created, each represented by a SimplePublicObjectBatchInputForCreate. Each object includes properties and associations necessary for creation. |
inputs[] | Model | Each item | Expand Batch create objects — fees batch Create Fees — request body — body inputs item |
Referenced models: Batch create objects — fees batch Create Fees — request body — body inputs item
Batch create objects — fees batch Create Fees — request body — body inputs item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An input object that contains a collection of objects to be created together in a batch. |
associations | array | Required within parent | An array of objects representing associations between the CRM object being created and other objects. Each association is defined by a 'PublicAssociationsForObject' schema. |
associations[] | Model | Each item | Expand Create — fees create Fee — request body — body associations item |
objectWriteTraceId | string | Optional | A string used to trace the write operation for debugging or logging purposes. |
properties | object | Required within parent | An object containing key-value pairs where keys are property names and values are the corresponding property values for the CRM object. Each property is a string. Additional keys: see wildcard field |
properties.* | string | Additional keys |
Referenced models: Create — fees create Fee — request body — body associations item
Create — fees create Fee — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Is the input object used to create a new CRM object, containing the properties to be set and optional associations to link the new record with other CRM objects. |
associations | array | Required within parent | An array of objects that define the associations between the new CRM object and other existing objects. Each association specifies the related object and the type of relationship. |
associations[] | Model | Each item | Expand Create — fees create Fee — request body — body associations item |
properties | object | Required within parent | An object containing key-value pairs representing the properties of the CRM object to be created. Each key is a property name, and the value is the property's value. Additional keys: see wildcard field |
properties.* | string | Additional keys |
Referenced models: Create — fees create Fee — request body — body associations item
Create — fees create Fee — request body — body associations item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the associations for a specific object in HubSpot, detailing the types of associations and the related objects involved. |
to | Model | Required within parent | Expand Read batch objects — carts batch Get Carts — request body — body inputs item |
types | array | Required within parent | An array of association specifications, each detailing the type of association between the objects. This includes information such as the association category and type ID. |
types[] | Model | Each item | Expand Create meeting — request body — body associations item types item |
Referenced models: Read batch objects — carts batch Get Carts — request body — body inputs item, Create meeting — request body — body associations item types item
Create — fees create Fee — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A simple public object. |
archived | boolean | Required within parent | A boolean indicating whether this object is archived. |
archivedAt | string | Optional | The date and time when this object was archived, in ISO 8601 format. Format: date-time |
createdAt | string | Required within parent | The date and time when this object was created, in ISO 8601 format. Format: date-time |
id | string | Required within parent | The unique identifier for this object, represented as a string. |
objectWriteTraceId | string | Optional | A string used to trace the write operations on this object. |
properties | object | Required within parent | A map of property names to their current values, represented as key-value pairs where both keys and values are strings. Additional keys: see wildcard field |
properties.* | string | Additional keys | |
propertiesWithHistory | object | Optional | A map of property names to their historical values, where each value is an array of objects containing the value and the timestamp when it was recorded. Additional keys: see wildcard field |
propertiesWithHistory.* | array | Additional keys | |
propertiesWithHistory.*[] | Model | Each item | Expand Read — fees get Fee — response body — properties With History value item |
updatedAt | string | Required within parent | The date and time when this object was last updated, in ISO 8601 format. Format: date-time |
url | string | Optional | A string representing the URL of this object. |
warnings | array | Optional | An array of warnings related to this object, where each warning includes a category, message, and context. |
warnings[] | Model | Each item | Expand Read — fees get Fee — response body — warnings item |
Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — properties With History value item
GDPR Delete — fees gdpr Delete — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An input that contains the information required to process a public GDPR data deletion request. |
idProperty | string | Optional | The name of a property whose values are unique for this object |
objectId | string | Required within parent | A string representing the unique identifier of the object to be deleted. This field is required. |
List Associations — fees get Associations By To Object Type — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a paginated collection of objects that are associated with multiple labels, including the results and pagination details. This component is used when retrieving associated objects with specific labels in a forward-paging manner. |
paging | Model | Optional | Expand Retrieve contacts — response body — paging |
results | array | Required within parent | An array of objects, each representing an association with multiple labels. Each object includes details about the associated object and the types of associations. |
results[] | Model | Each item | Expand List Associations — fees get Associations By To Object Type — response body — results item |
Referenced models: Retrieve contacts — response body — paging, List Associations — fees get Associations By To Object Type — response body — results item
List Associations — fees get Associations By To Object Type — response body — results item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents an object that is associated with multiple other objects, with optional context. |
associationTypes | array | Required within parent | An array of association specifications with labels, detailing the types of associations and their corresponding labels. Each item in the array is an object of type AssociationSpecWithLabel. |
associationTypes[] | Model | Each item | Expand List Associations — fees get Associations By To Object Type — response body — results item association Types item |
toObjectId | string | Required within parent | The unique identifier of the object to which associations are being made. This is a string value. |
Referenced models: List Associations — fees get Associations By To Object Type — response body — results item association Types item
List Associations — fees get Associations By To Object Type — response body — results item association Types item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Defines the type, direction, and details of the relationship between two CRM objects. |
category | string | Required within parent | The category of the association, indicating its origin. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'. Known values: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK |
fromObjectTypeId | string | Optional | The object type ID of the source object in the association. |
label | string | Optional | A string label that describes the association. |
toObjectTypeId | string | Optional | The object type ID of the target object in the association. |
typeId | JSON | Required within parent | |
typeId (anyOf 1) | integer | Alternative | An integer representing the unique identifier for the type of association. Format: int32 |
typeId (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
List — fees get Fees — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a paginated collection response that includes simple public objects with their associations. This component is used to handle the results and pagination details when retrieving a list of objects from the API. |
paging | Model | Optional | Expand Retrieve contacts — response body — paging |
results | array | Required within parent | An array of SimplePublicObjectWithAssociations, each representing a CRM object with its associated data. |
results[] | Model | Each item | Expand Read — fees get Fee — response body |
Referenced models: Retrieve contacts — response body — paging, Read — fees get Fee — response body
Merge objects — fees merge — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Input data for merging two records. |
objectIdToMerge | string | Required within parent | The unique identifier of the object that will be merged into the primary object. This is a string. |
primaryObjectId | string | Required within parent | The unique identifier of the object that will remain as the primary object after the merge. This is a string. |
Read batch objects — fees batch Get Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Specifies the input for reading a batch of CRM objects, including arrays of object IDs, requested property names (with optional history), and an optional unique identifying property. |
idProperty | string | Optional | When using a custom unique value property to retrieve records, the name of the property. Do not include this parameter if retrieving by record ID. |
inputs | array | Required within parent | An array of SimplePublicObjectId objects, each containing an ID that identifies the CRM objects to be read. |
inputs[] | Model | Each item | Expand Archive a batch of contacts — request body — body inputs item |
properties | array | Required within parent | An array of strings representing the properties to be returned in the response. If any of the specified properties are not present on the requested objects, they will be ignored. |
properties[] | string | Each item | |
propertiesWithHistory | array | Required within parent | An array of strings representing the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested objects, they will be ignored. |
propertiesWithHistory[] | string | Each item |
Referenced models: Archive a batch of contacts — request body — body inputs item
Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a standard error response in the HubSpot API, providing detailed information about an error that occurred during an API request. |
category | string | Required within parent | A string indicating the category of the error. |
context | object | Required within parent | An object containing additional context about the error, represented as a map of string keys to arrays of strings. Additional keys: see wildcard field |
context.* | array | Additional keys | |
context.*[] | string | Each item | |
errors | array | Required within parent | An array of ErrorDetail objects, each providing further information about specific aspects of the error. |
errors[] | Model | Each item | Expand Batch insert events — response body — errors item errors item |
id | string | Optional | A string that uniquely identifies the error instance. |
links | object | Required within parent | An object containing a map of link names to associated URIs, providing documentation or recommended remediation steps related to the error. Additional keys: see wildcard field |
links.* | string | Additional keys | |
message | string | Required within parent | A string containing a human-readable message that describes the error. |
status | string | Required within parent | A string representing the status of the error. |
subCategory | object | Optional | An object providing additional categorization of the error, allowing for more specific error details. |
Referenced models: Batch insert events — response body — errors item errors item
Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Object
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A public object batch response object |
completedAt | string | Required within parent | The date and time when the batch operation was completed, in ISO 8601 format. Format: date-time |
links | object | Optional | A map of link names to associated URIs, providing additional information or actions related to the batch operation. Additional keys: see wildcard field |
links.* | string | Additional keys | |
requestedAt | string | Optional | The date and time when the batch operation was requested, in ISO 8601 format. Format: date-time |
results | array | Required within parent | An array of SimplePublicObject items representing the results of the batch operation. |
results[] | Model | Each item | Expand Create — fees create Fee — response body |
startedAt | string | Required within parent | The date and time when the batch operation started, in ISO 8601 format. Format: date-time |
status | string | Required within parent | The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'. Known values: CANCELED, COMPLETE, PENDING, PROCESSING |
Referenced models: Create — fees create Fee — response body
Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Object With Errors
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the result of a batch operation on CRM objects, including the processing status, batch results, timestamps, and a list of any errors encountered during the operation. |
completedAt | string | Required within parent | The date and time when the batch operation was completed, in ISO 8601 format. Format: date-time |
errors | array | Optional | An array of StandardError objects detailing any errors that occurred during the batch operation. |
errors[] | Model | Each item | Expand Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item |
links | object | Optional | A map of link names to associated URIs for additional information or actions related to the batch operation. Additional keys: see wildcard field |
links.* | string | Additional keys | |
numErrors | JSON | Optional | |
numErrors (anyOf 1) | integer | Alternative | The number of errors encountered during the batch operation. Format: int32 |
numErrors (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
requestedAt | string | Optional | The date and time when the batch operation was requested, in ISO 8601 format. Format: date-time |
results | array | Required within parent | An array of SimplePublicObject items representing the results of the batch operation. |
results[] | Model | Each item | Expand Create — fees create Fee — response body |
startedAt | string | Required within parent | The date and time when the batch operation started, in ISO 8601 format. Format: date-time |
status | string | Required within parent | The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'. Known values: CANCELED, COMPLETE, PENDING, PROCESSING |
Referenced models: Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Create — fees create Fee — response body
Read — fees get Fee — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type. |
archived | boolean | Required within parent | A boolean indicating whether this object has been archived. |
archivedAt | string | Optional | The date and time when this object was archived, in ISO 8601 format. Format: date-time |
associations | object | Optional | A map of associated object types to their associated IDs, representing the relationships this object has with other objects. Additional keys: see wildcard field |
associations.* | Model | Additional keys | Expand Read — fees get Fee — response body — associations value |
createdAt | string | Required within parent | The date and time when this object was created, in ISO 8601 format. Format: date-time |
id | string | Required within parent | The unique identifier for this object. |
objectWriteTraceId | string | Optional | An identifier used for tracing the write operations on this object. |
properties | object | Required within parent | A map of property names to their values for this object. Additional keys: see wildcard field |
properties.* | string | Additional keys | |
propertiesWithHistory | object | Optional | A map of property names to their values along with a history of changes, including timestamps. Additional keys: see wildcard field |
propertiesWithHistory.* | array | Additional keys | |
propertiesWithHistory.*[] | Model | Each item | Expand Read — fees get Fee — response body — properties With History value item |
updatedAt | string | Required within parent | The date and time when this object was last updated, in ISO 8601 format. Format: date-time |
url | string | Optional | The URL link to access this object. |
warnings | array | Optional | A list of warnings related to this object, each containing a category, message, and context. |
warnings[] | Model | Each item | Expand Read — fees get Fee — response body — warnings item |
Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — associations value, Read — fees get Fee — response body — properties With History value item
Read — fees get Fee — response body — associations value
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a collection of associated IDs returned by an API request, including pagination details for navigating through the results. |
paging | Model | Optional | Expand Search objects — fees search Fees — response body — paging |
results | array | Required within parent | An array of associated IDs, each represented by an object containing the ID and type of the association. |
results[] | Model | Each item | Expand Read — fees get Fee — response body — associations value results item |
Referenced models: Read — fees get Fee — response body — associations value results item, Search objects — fees search Fees — response body — paging
Read — fees get Fee — response body — associations value results item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Contains the id and type of an association |
id | string | Required within parent | A string representing the unique identifier of the associated object. |
type | string | Required within parent | A string indicating the type of the associated object. |
Read — fees get Fee — response body — properties With History value item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Property model that includes timestamp. |
sourceId | string | Optional | The unique identifier of the source that provided the value. It is a string. |
sourceLabel | string | Optional | A label describing the source of the value. It is a string. |
sourceType | string | Required within parent | The type of source that provided the value. It is a string. |
timestamp | string | Required within parent | The date and time when the value was recorded, in ISO 8601 format. Format: date-time |
updatedByUserId | JSON | Optional | |
updatedByUserId (anyOf 1) | integer | Alternative | The ID of the user who last updated the value. It is an integer. Format: int32 |
updatedByUserId (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
value | string | Required within parent | The value of the property at the given timestamp. It is a string. |
Read — fees get Fee — response body — warnings item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a warning message related to a public object in HubSpot, providing details about the nature and context of the warning. |
category | string | Required within parent | A string indicating the category of the warning. |
context | object | Required within parent | An object providing additional context for the warning, with string properties. Additional keys: see wildcard field |
context.* | string | Additional keys | |
message | string | Required within parent | A string containing the warning message. |
Search objects — fees search Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Describes a search request |
after | string | Required within parent | A string representing the paging cursor token, used to retrieve the next set of results in a paginated response. |
filterGroups | array | Required within parent | An array of filter groups used to narrow down the search results. Each filter group contains multiple filters that are combined using logical AND operations. |
filterGroups[] | Model | Each item | Expand Search objects — fees search Fees — request body — body filter Groups item |
limit | integer | Required within parent | An integer specifying the maximum number of results to return. Format: int32 |
properties | array | Required within parent | An array of strings indicating which properties of the objects should be included in the search results. |
properties[] | string | Each item | |
query | string | Optional | A string used to perform a full-text search across the specified properties. |
sorts | array | Required within parent | An array of strings specifying the sorting order of the search results. Each string represents a property to sort by, optionally prefixed with a '-' to indicate descending order. |
sorts[] | string | Each item |
Referenced models: Search objects — fees search Fees — request body — body filter Groups item
Search objects — fees search Fees — request body — body filter Groups item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a group of filters used to query data within HubSpot. This component is used to define criteria for filtering records in various API endpoints. |
filters | array | Required within parent | An array of filter objects that specify the conditions to apply in the search. Each filter defines a property, an operator, and a value to match against. |
filters[] | Model | Each item | Expand Search objects — fees search Fees — request body — body filter Groups item filters item |
Referenced models: Search objects — fees search Fees — request body — body filter Groups item filters item
Search objects — fees search Fees — request body — body filter Groups item filters item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Defines a single condition for searching CRM objects, specifying the property to filter on, the operator to use (such as equals, greater than, or contains), and the value(s) to compare against. |
highValue | string | Optional | An optional string used for range-based filters to specify the upper bound of the range. |
operator | string | Required within parent | The operator used to compare the property value with the specified value(s). Valid operators include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'. One of: BETWEEN, CONTAINS_TOKEN, EQ, GT, GTE, HAS_PROPERTY, IN, LT, LTE, NEQ, NOT_CONTAINS_TOKEN, NOT_HAS_PROPERTY, NOT_IN |
propertyName | string | Required within parent | The name of the property to filter by. It is a string that specifies which property of the object is being evaluated. |
value | string | Optional | The value to compare against the specified property. It is a string used in conjunction with the operator to determine if the object meets the filter criteria. |
values | array | Optional | An array of strings used for filters that involve multiple values, such as 'IN' or 'NOT_IN' operators. |
values[] | string | Each item |
Search objects — fees search Fees — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a list of simple objects returned from an API request, along with the total count of objects available. |
paging | Model | Optional | Expand Search objects — fees search Fees — response body — paging |
results | array | Required within parent | An array of SimplePublicObject items, each representing an individual CRM object. |
results[] | Model | Each item | Expand Create — fees create Fee — response body |
total | JSON | Required within parent | |
total (anyOf 1) | integer | Alternative | The number of available results Format: int32 |
total (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Referenced models: Search objects — fees search Fees — response body — paging, Create — fees create Fee — response body
Search objects — fees search Fees — response body — paging
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results. |
next | Model | Optional | Expand Retrieve contacts — response body — paging next |
prev | Model | Optional | Expand Search objects — fees search Fees — response body — paging prev |
Referenced models: Retrieve contacts — response body — paging next, Search objects — fees search Fees — response body — paging prev
Search objects — fees search Fees — response body — paging prev
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | specifies the paging information needed to retrieve the previous set of results in a paginated API response |
before | string | Required within parent | A string token that indicates the position of the last item on the previous page. |
link | string | Optional | A string URL that provides a direct link to the previous page of results. |
Update batch objects — fees batch Update Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a batch input component used to handle multiple simple public objects in a single API request. This component is typically used when performing batch operations to create, update, or delete multiple records simultaneously. |
inputs | array | Required within parent | An array of SimplePublicObjectBatchInput objects, each containing the properties and identifiers for a CRM object to be updated. |
inputs[] | Model | Each item | Expand Update batch objects — fees batch Update Fees — request body — body inputs item |
Referenced models: Update batch objects — fees batch Update Fees — request body — body inputs item
Update batch objects — fees batch Update Fees — request body — body inputs item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Contains an array of CRM object records to be processed in a batch operation, each defined by their ID and properties. |
id | string | Required within parent | The id to be updated. This can be the object id, or the unique property value of the idProperty property |
idProperty | string | Optional | The name of a property whose values are unique for this object |
objectWriteTraceId | string | Optional | A string used to trace the write operation for debugging or logging purposes. |
properties | object | Required within parent | A map of property names to their values, representing the data of the CRM object. Each property is a string. Additional keys: see wildcard field |
properties.* | string | Additional keys |
Update — fees update Fee — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the input required to update a CRM object, containing an object with property names and their corresponding values. |
properties | object | Required within parent | An object containing key-value pairs where each key is a property name and the value is the property value. All properties are represented as strings. Additional keys: see wildcard field |
properties.* | string | Additional keys |
Upsert batch objects — fees batch Upsert Fees — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a batch input operation for upserting simple public objects in HubSpot. This component is used to process multiple upsert operations in a single request, improving efficiency and performance. |
inputs | array | Required within parent | An array of SimplePublicObjectBatchInputUpsert objects, each representing a CRM object to be created or updated. Each object must include properties such as 'id' and 'properties'. |
inputs[] | Model | Each item | Expand Upsert batch objects — fees batch Upsert Fees — request body — body inputs item |
Referenced models: Upsert batch objects — fees batch Upsert Fees — request body — body inputs item
Upsert batch objects — fees batch Upsert Fees — request body — body inputs item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents an object used in batch upsert operations, containing an object’s unique identifier, its properties, and optionally the unique property name and a write trace ID. |
id | string | Required within parent | A string representing the unique identifier for the object. |
idProperty | string | Optional | The name of a property whose values are unique for this object |
objectWriteTraceId | string | Optional | An optional string identifier used to trace the write operation for debugging or logging purposes. |
properties | object | Required within parent | A map of property names to their values for the object. Each property is a string. Additional keys: see wildcard field |
properties.* | string | Additional keys |
Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents a CRM object that has either been created or updated (upserted) |
archived | boolean | Required within parent | A boolean indicating whether this object is archived. |
archivedAt | string | Optional | The date and time when this object was archived, in ISO 8601 format. Format: date-time |
createdAt | string | Required within parent | The date and time when this object was created, in ISO 8601 format. Format: date-time |
id | string | Required within parent | The unique identifier for this object, represented as a string. |
new | boolean | Required within parent | A boolean indicating whether this object is newly created (true) or updated (false). |
objectWriteTraceId | string | Optional | A string used to trace the write operation for this object. |
properties | object | Required within parent | A map of property names to their values for this object, with each value represented as a string. Additional keys: see wildcard field |
properties.* | string | Additional keys | |
propertiesWithHistory | object | Optional | A map of property names to their historical values, where each value is an array of objects containing the value and the timestamp when it was recorded. Additional keys: see wildcard field |
propertiesWithHistory.* | array | Additional keys | |
propertiesWithHistory.*[] | Model | Each item | Expand Read — fees get Fee — response body — properties With History value item |
updatedAt | string | Required within parent | The date and time when this object was last updated, in ISO 8601 format. Format: date-time |
url | string | Optional | A string representing the URL of this object. |
warnings | array | Optional | An array of warnings associated with this object, where each warning includes a category, message, and context. |
warnings[] | Model | Each item | Expand Read — fees get Fee — response body — warnings item |
Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — properties With History value item
Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Upsert Object
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the result of a batch upsert operation, including the operation’s status, timestamps, and a list of successfully created or updated objects. |
completedAt | string | Required within parent | The date and time when the batch operation was completed, in ISO 8601 format. Format: date-time |
links | object | Optional | A map of link names to associated URIs, providing additional information about the batch operation. Additional keys: see wildcard field |
links.* | string | Additional keys | |
requestedAt | string | Optional | The date and time when the batch operation was requested, in ISO 8601 format. Format: date-time |
results | array | Required within parent | An array of results from the batch upsert operation, each represented as a SimplePublicUpsertObject. |
results[] | Model | Each item | Expand Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item |
startedAt | string | Required within parent | The date and time when the batch operation started, in ISO 8601 format. Format: date-time |
status | string | Required within parent | The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'. Known values: CANCELED, COMPLETE, PENDING, PROCESSING |
Referenced models: Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Upsert Object With Errors
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Represents the response from a batch upsert operation, including the status, timestamps, successfully processed objects, and any errors that occurred during processing. |
completedAt | string | Required within parent | The date and time when the batch operation was completed, in ISO 8601 format. Format: date-time |
errors | array | Optional | An array of StandardError objects detailing any errors that occurred during the batch operation. |
errors[] | Model | Each item | Expand Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item |
links | object | Optional | A map of link names to associated URIs, providing additional context or navigation related to the batch operation. Additional keys: see wildcard field |
links.* | string | Additional keys | |
numErrors | JSON | Optional | |
numErrors (anyOf 1) | integer | Alternative | The total number of errors encountered during the batch operation. Format: int32 |
numErrors (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
requestedAt | string | Optional | The date and time when the batch operation was requested, in ISO 8601 format. Format: date-time |
results | array | Required within parent | An array of SimplePublicUpsertObject items representing the results of the batch upsert operation. |
results[] | Model | Each item | Expand Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item |
startedAt | string | Required within parent | The date and time when the batch operation started, in ISO 8601 format. Format: date-time |
status | string | Required within parent | The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'. Known values: CANCELED, COMPLETE, PENDING, PROCESSING |
Referenced models: Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item