{
"ab_internal": {
"isEnterprise": false,
"ql": 400,
"requireVersionIncrementsInPullRequests": true,
"sl": 300
},
"allowedHosts": {
"hosts": [
"api.hubapi.com"
]
},
"connectorBuildOptions": {
"baseImage": "docker.io/airbyte/source-declarative-manifest:7.13.0.post13.dev23806774478@sha256:3454e270979f4e239c538cc9200cc872d54815f60752d997d419ed51434ff7bf"
},
"connectorTestSuitesOptions": [
{
"suite": "liveTests",
"testConnections": [
{
"id": "52e28dc7-2245-4ebc-a591-0ef954ce4837",
"name": "hubspot_config_dev_null"
},
{
"id": "5a4058bf-0ab3-427e-92e4-9051c0abf655",
"name": "hubspot_config_oauth_dev_null"
},
{
"id": "67bf1886-3ae0-4fad-8c37-90eb51b2c748",
"name": "hubspot_config_oauth_no_start_date_dev_null"
}
]
},
{
"suite": "unitTests"
},
{
"suite": "integrationTests",
"testSecrets": [
{
"fileName": "config.json",
"name": "SECRET_SOURCE-HUBSPOT_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth_no_start_date.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_NO_START_DATE_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth_no_start_date.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_NO_START_DATE__CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
}
]
},
{
"suite": "acceptanceTests",
"testSecrets": [
{
"fileName": "config.json",
"name": "SECRET_SOURCE-HUBSPOT_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth_no_start_date.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_NO_START_DATE_CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
},
{
"fileName": "config_oauth_no_start_date.json",
"name": "SECRET_SOURCE-HUBSPOT_OAUTH_NO_START_DATE__CREDS",
"secretStore": {
"alias": "airbyte-connector-testing-secret-store",
"type": "GSM"
}
}
]
}
],
"custom": false,
"dockerImageTag": "6.3.5-preview.f093cb0",
"dockerRepository": "airbyte/source-hubspot",
"documentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot",
"erdUrl": "https://dbdocs.io/airbyteio/source-hubspot?view=relationships",
"externalDocumentationUrls": [
{
"title": "HubSpot API reference",
"type": "api_reference",
"url": "https://developers.hubspot.com/docs/api/overview"
},
{
"title": "HubSpot API changelog",
"type": "api_release_history",
"url": "https://developers.hubspot.com/changelog"
},
{
"title": "HubSpot authentication",
"type": "authentication_guide",
"url": "https://developers.hubspot.com/docs/api/oauth-quickstart-guide"
},
{
"title": "HubSpot rate limits",
"type": "rate_limits",
"url": "https://developers.hubspot.com/docs/api/usage-details"
},
{
"title": "HubSpot Status",
"type": "status_page",
"url": "https://status.hubspot.com/"
}
],
"generated": {
"git": {
"commit_author": "Devin AI",
"commit_author_email": "158243242+devin-ai-integration[bot]@users.noreply.github.com",
"commit_sha": "f093cb02b3d60c8906356215990f1d63ece5578e",
"commit_timestamp": "2026-03-31T16:14:54+00:00"
},
"sbomUrl": "https://connectors.airbyte.com/files/sbom/airbyte/source-hubspot/6.3.5-preview.f093cb0.spdx.json",
"source_file_info": {
"metadata_bucket_name": "prod-airbyte-cloud-connector-metadata-service",
"metadata_file_path": "metadata/airbyte/source-hubspot/6.3.5-preview.f093cb0/metadata.yaml",
"metadata_last_modified": "2026-03-31T16:32:44.262264+00:00",
"registry_entry_generated_at": "2026-03-31T16:32:44.262264+00:00"
}
},
"githubIssueLabel": "source-hubspot",
"icon": "hubspot.svg",
"iconUrl": "https://connectors.airbyte.com/files/metadata/airbyte/source-hubspot/latest/icon.svg",
"language": "manifest-only",
"license": "ELv2",
"maxSecondsBetweenMessages": 86400,
"name": "HubSpot",
"packageInfo": {},
"public": true,
"releaseStage": "generally_available",
"releases": {
"breakingChanges": {
"2.0.0": {
"message": "This version replaces the `Property History` stream in favor of creating 3 different streams: `Contacts`, `Companies`, and `Deals`, which can now all fetch their property history. It will affect only users who use `Property History` stream, who will need to fix schema conflicts and sync `Contacts Property History` stream instead of `Property History`.",
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#2.0.0",
"upgradeDeadline": "2024-01-15"
},
"3.0.0": {
"message": "This update brings extended schema with data type changes for the Marketing Emails stream. Users will need to refresh it and reset this stream after upgrading.",
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#3.0.0",
"scopedImpact": [
{
"impactedScopes": [
"marketing_emails"
],
"scopeType": "stream"
}
],
"upgradeDeadline": "2024-02-12"
},
"4.0.0": {
"message": "This update brings extended schema with data type changes for the streams `Deals Property History` and `Companies Property History`. Users will need to refresh their schema and reset their streams after upgrading.",
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#4.0.0",
"scopedImpact": [
{
"impactedScopes": [
"deals_property_history",
"companies_property_history"
],
"scopeType": "stream"
}
],
"upgradeDeadline": "2024-03-10"
},
"5.0.0": {
"deadlineAction": "auto_upgrade",
"message": "This update deprecates the `contacts_form_submissions`, `contacts_list_memberships`, and `contacts_merged_audit` streams from the source because they are no longer supported in Hubspot's V3 API and the V1 API is being deprecated on 2025-09-30. Updates the `contact_lists` stream to use V3 API, which contains changes to the schema due to old fields no longer exposed by the V3 API. Users will need to refresh the source schema and clear the stream.",
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#5.0.0",
"scopedImpact": [
{
"impactedScopes": [
"contact_lists",
"contacts_form_submissions",
"contacts_list_memberships",
"contacts_merged_audit"
],
"scopeType": "stream"
}
],
"upgradeDeadline": "2025-06-15"
},
"6.0.0": {
"deadlineAction": "auto_upgrade",
"message": "This update migrates the `marketing_emails` stream from HubSpot's deprecated v1 API to the new v3 API. While this migration significantly changes the schema of the stream, removing many fields that were previously present, it also enables incremental sync support for the stream. Users will need to refresh the source schema and reset the `marketing_emails` stream after upgrading. Please refer to the [migration guide](https://docs.airbyte.com/integrations/sources/hubspot-migrations) for more information.",
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#6.0.0",
"scopedImpact": [
{
"impactedScopes": [
"marketing_emails"
],
"scopeType": "stream"
}
],
"upgradeDeadline": "2025-09-30"
}
},
"migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations",
"rolloutConfiguration": {
"advanceDelayMinutes": 10,
"enableProgressiveRollout": false,
"initialPercentage": 0,
"maxPercentage": 50
}
},
"remoteRegistries": {
"pypi": {
"enabled": false,
"packageName": "airbyte-source-hubspot"
}
},
"resourceRequirements": {
"jobSpecific": [
{
"jobType": "check_connection",
"resourceRequirements": {
"memory_limit": "1600Mi",
"memory_request": "1600Mi"
}
},
{
"jobType": "discover_schema",
"resourceRequirements": {
"memory_limit": "1024Mi",
"memory_request": "1024Mi"
}
}
]
},
"sourceDefinitionId": "36c891d9-4bd9-43ac-bad2-10e12756272c",
"sourceType": "api",
"spec": {
"advanced_auth": {
"auth_flow_type": "oauth2.0",
"oauth_config_specification": {
"complete_oauth_output_specification": {
"additionalProperties": false,
"properties": {
"refresh_token": {
"path_in_connector_config": [
"credentials",
"refresh_token"
],
"type": "string"
}
},
"type": "object"
},
"complete_oauth_server_input_specification": {
"additionalProperties": false,
"properties": {
"client_id": {
"type": "string"
},
"client_secret": {
"type": "string"
}
},
"type": "object"
},
"complete_oauth_server_output_specification": {
"additionalProperties": false,
"properties": {
"client_id": {
"path_in_connector_config": [
"credentials",
"client_id"
],
"type": "string"
},
"client_secret": {
"path_in_connector_config": [
"credentials",
"client_secret"
],
"type": "string"
}
},
"type": "object"
}
},
"predicate_key": [
"credentials",
"credentials_title"
],
"predicate_value": "OAuth Credentials"
},
"connectionSpecification": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"credentials": {
"description": "Choose how to authenticate to HubSpot.",
"oneOf": [
{
"properties": {
"client_id": {
"description": "The Client ID of your HubSpot developer application. See the Hubspot docs if you need help finding this ID.",
"examples": [
"123456789000"
],
"title": "Client ID",
"type": "string"
},
"client_secret": {
"airbyte_secret": true,
"description": "The client secret for your HubSpot developer application. See the Hubspot docs if you need help finding this secret.",
"examples": [
"secret"
],
"title": "Client Secret",
"type": "string"
},
"credentials_title": {
"const": "OAuth Credentials",
"description": "Name of the credentials",
"order": 0,
"title": "Auth Type",
"type": "string"
},
"refresh_token": {
"airbyte_secret": true,
"description": "Refresh token to renew an expired access token. See the Hubspot docs if you need help finding this token.",
"examples": [
"refresh_token"
],
"title": "Refresh Token",
"type": "string"
}
},
"required": [
"client_id",
"client_secret",
"refresh_token",
"credentials_title"
],
"title": "OAuth",
"type": "object"
},
{
"properties": {
"access_token": {
"airbyte_secret": true,
"description": "HubSpot Access token. See the Hubspot docs if you need help finding this token.",
"title": "Access token",
"type": "string"
},
"credentials_title": {
"const": "Private App Credentials",
"description": "Name of the credentials set",
"order": 0,
"title": "Auth Type",
"type": "string"
}
},
"required": [
"access_token",
"credentials_title"
],
"title": "Private App",
"type": "object"
}
],
"title": "Authentication",
"type": "object"
},
"enable_experimental_streams": {
"default": false,
"description": "If enabled then experimental streams become available for sync.",
"title": "Enable experimental streams",
"type": "boolean"
},
"lookback_window": {
"default": 0,
"description": "How far back (in minutes) to re-fetch records during incremental syncs. Set this if you notice missing records in CRMSearch streams to recover data that may be delayed by the HubSpot API.",
"examples": [
60
],
"maximum": 576000,
"minimum": 0,
"title": "Lookback window",
"type": "integer"
},
"num_worker": {
"default": 10,
"description": "The number of worker threads to use for the sync.",
"examples": [
1,
2,
3
],
"maximum": 40,
"minimum": 1,
"title": "Number of concurrent workers",
"type": "integer"
},
"start_date": {
"description": "UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated. If not set, \"2006-06-01T00:00:00Z\" (Hubspot creation date) will be used as start date. It's recommended to provide relevant to your data start date value to optimize synchronization.",
"examples": [
"2017-01-25T00:00:00Z"
],
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"title": "Start date",
"type": "string"
}
},
"required": [
"credentials"
],
"title": "HubSpot Source Spec",
"type": "object"
},
"supportsDBT": false,
"supportsNormalization": false
},
"suggestedStreams": {
"streams": [
"contacts",
"companies",
"deals"
]
},
"supportLevel": "certified",
"supportsDataActivation": false,
"supportsFileTransfer": false,
"tags": [
"language:manifest-only",
"cdk:low-code"
],
"tombstone": false
}