Optional
requestFactory: BasicApiRequestFactoryOptional
responseProcessor: BasicApiResponseProcessorThe ID of the contact to delete.
Optional
_options: PromiseConfigurationOptionsDelete a contact by ID. Deleted contacts can be restored within 90 days of deletion. Learn more about the data impacted by contact deletions and how to restore archived records. Archive a contact
The ID of the contact to delete.
Optional
_options: PromiseConfigurationOptionsCreate a single contact. Include a properties
object to define property values for the contact, along with an associations
array to define associations with other CRM records.
Create a contact
Optional
_options: PromiseConfigurationOptionsCreate a single contact. Include a properties
object to define property values for the contact, along with an associations
array to define associations with other CRM records.
Create a contact
Optional
_options: PromiseConfigurationOptionsRetrieve a contact by its ID (contactId
) or by a unique property (idProperty
). You can specify what is returned using the properties
query parameter.
Retrieve a contact
The ID of the contact to retrieve.
Optional
properties: string[]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.
Optional
propertiesWithHistory: string[]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.
Optional
associations: string[]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.
Optional
archived: booleanWhether to return only results that have been archived.
Optional
idProperty: stringThe name of a property whose values are unique for this object type
Optional
_options: PromiseConfigurationOptionsRetrieve a contact by its ID (contactId
) or by a unique property (idProperty
). You can specify what is returned using the properties
query parameter.
Retrieve a contact
The ID of the contact to retrieve.
Optional
properties: string[]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.
Optional
propertiesWithHistory: string[]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.
Optional
associations: string[]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.
Optional
archived: booleanWhether to return only results that have been archived.
Optional
idProperty: stringThe name of a property whose values are unique for this object type
Optional
_options: PromiseConfigurationOptionsRetrieve all contacts, using query parameters to specify the information that gets returned. Retrieve contacts
Optional
limit: numberThe maximum number of results to display per page.
Optional
after: stringThe 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.
Optional
properties: string[]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.
Optional
propertiesWithHistory: string[]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.
Optional
associations: string[]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.
Optional
archived: booleanWhether to return only results that have been archived.
Optional
_options: PromiseConfigurationOptionsRetrieve all contacts, using query parameters to specify the information that gets returned. Retrieve contacts
Optional
limit: numberThe maximum number of results to display per page.
Optional
after: stringThe 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.
Optional
properties: string[]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.
Optional
propertiesWithHistory: string[]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.
Optional
associations: string[]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.
Optional
archived: booleanWhether to return only results that have been archived.
Optional
_options: PromiseConfigurationOptionsMerge two contact records. Learn more about merging records. Merge two contacts
Optional
_options: PromiseConfigurationOptionsMerge two contact records. Learn more about merging records. Merge two contacts
Optional
_options: PromiseConfigurationOptionsPermanently 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. Learn more about permanently deleting contacts.
Permanently delete a contact (GDPR-compliant)
Optional
_options: PromiseConfigurationOptionsPermanently 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. Learn more about permanently deleting contacts.
Permanently delete a contact (GDPR-compliant)
Optional
_options: PromiseConfigurationOptionsUpdate a contact by ID (contactId
) or unique property value (idProperty
). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
Update a contact
The ID of the contact to update.
Optional
idProperty: stringThe name of a property whose values are unique for this object type
Optional
_options: PromiseConfigurationOptionsUpdate a contact by ID (contactId
) or unique property value (idProperty
). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
Update a contact
The ID of the contact to update.
Optional
idProperty: stringThe name of a property whose values are unique for this object type
Optional
_options: PromiseConfigurationOptions
Delete a contact by ID. Deleted contacts can be restored within 90 days of deletion. Learn more about the data impacted by contact deletions and how to restore archived records. Archive a contact