Skip to navigation

Supports:

  • ✅ Models
  • ✅ Model sync destination
  • ✅ Bulk sync source
  • ✅ Connection Proxy

Connection

Configuration

NameTypeDescriptionRequired
client_idstringoptional
client_secretstringoptional
include_static_list_supportbooleanEnable segment (list) supportoptional
oauth_refresh_tokenstringoptional
use_search_apibooleanUse HubSpot incremental API for bulk syncsoptional
Read-only propertyTypeDescription
hub_domainstringHubSpot domain
hub_userstringHubSpot user

Example

{
"name": "HubSpot connection",
"type": "hubspot",
"configuration": {
"client_id": "a45gadsfdsaf47byor2ugfbhsgllpf12gf56gfds",
"client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
"include_static_list_support": false,
"oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
"use_search_api": false
}
}

Model Sync

Source

Configuration

NameTypeDescriptionRequired
list_idstringRecordsoptional
stream_idstringoptional

Example

{
...
"configuration": {
"list_id": "",
"stream_id": "companies"
}
}

Target

HubSpot connections may be used as the destination in a model sync. Some destinations support additional configuration.

Companies

Applies to:

  • companies
Configuration
NameTypeDescriptionRequired
create_with_empty_identitybooleanSync records with an empty identity value

Do not omit records with an empty identity value from create or create and update mode syncs when hs_object_id is the identity mapping.
optional
ingestion_apistringIngestion API

Accepted values: automatic, object
optional
invalid_relationshipsstringRecords with invalid relationship IDs

Accepted values: error, omit_values, omit_records
optional
match_additional_domainsbooleanMatch against HubSpot’s ‘Additional domains’ fieldoptional
replace_associationsbooleanReplace existing relationshipsoptional
write_null_valuesbooleanCopy null valuesoptional
Example
{
...
"target": {
"configuration": {
"create_with_empty_identity": false,
"ingestion_api": "automatic",
"invalid_relationships": "omit_values",
"match_additional_domains": false,
"replace_associations": false,
"write_null_values": false
}
}
}

Contacts

Applies to:

  • contacts
Configuration
NameTypeDescriptionRequired
create_with_empty_identitybooleanSync records with an empty identity value

Do not omit records with an empty identity value from create or create and update mode syncs when hs_object_id is the identity mapping.
optional
ignore_additional_emailsbooleanIgnore HubSpot’s ‘Additional emails’ fieldoptional
ingestion_apistringIngestion API

Accepted values: automatic, object
optional
invalid_relationshipsstringRecords with invalid relationship IDs

Accepted values: error, omit_values, omit_records
optional
replace_associationsbooleanReplace existing relationshipsoptional
write_null_valuesbooleanCopy null valuesoptional
Example
{
...
"target": {
"configuration": {
"create_with_empty_identity": false,
"ignore_additional_emails": true,
"ingestion_api": "automatic",
"invalid_relationships": "omit_values",
"replace_associations": false,
"write_null_values": false
}
}
}

Other targets

Configuration
NameTypeDescriptionRequired
create_with_empty_identitybooleanSync records with an empty identity value

Do not omit records with an empty identity value from create or create and update mode syncs when hs_object_id is the identity mapping.
optional
ingestion_apistringIngestion API

Accepted values: automatic, object
optional
invalid_relationshipsstringRecords with invalid relationship IDs

Accepted values: error, omit_values, omit_records
optional
replace_associationsbooleanReplace existing relationshipsoptional
write_null_valuesbooleanCopy null valuesoptional
Example
{
...
"target": {
"configuration": {
"create_with_empty_identity": false,
"ingestion_api": "automatic",
"invalid_relationships": "omit_values",
"replace_associations": false,
"write_null_values": false
}
}
}

Bulk Sync

Source

Configuration

NameTypeDescriptionRequired
include_archivedbooleanInclude archived HubSpot recordsoptional

Example

{
...
"source_configuration": {
"include_archived": false
}
}