{"sourceDefinitionId": "36c891d9-4bd9-43ac-bad2-10e12756272c", "name": "HubSpot", "dockerRepository": "airbyte/source-hubspot", "dockerImageTag": "6.3.1-preview.8e5fdeb", "documentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot", "icon": "hubspot.svg", "iconUrl": "https://connectors.airbyte.com/files/metadata/airbyte/source-hubspot/latest/icon.svg", "sourceType": "api", "spec": {"connectionSpecification": {"$schema": "http://json-schema.org/draft-07/schema#", "title": "HubSpot Source Spec", "type": "object", "required": ["credentials"], "additionalProperties": true, "properties": {"start_date": {"type": "string", "title": "Start date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$", "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"}, "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"}, "credentials": {"title": "Authentication", "description": "Choose how to authenticate to HubSpot.", "type": "object", "oneOf": [{"type": "object", "title": "OAuth", "required": ["client_id", "client_secret", "refresh_token", "credentials_title"], "properties": {"credentials_title": {"type": "string", "title": "Auth Type", "description": "Name of the credentials", "const": "OAuth Credentials", "order": 0}, "client_id": {"title": "Client ID", "description": "The Client ID of your HubSpot developer application. See the <a href=\"https://legacydocs.hubspot.com/docs/methods/oauth2/oauth2-quickstart\">Hubspot docs</a> if you need help finding this ID.", "type": "string", "examples": ["123456789000"]}, "client_secret": {"title": "Client Secret", "description": "The client secret for your HubSpot developer application. See the <a href=\"https://legacydocs.hubspot.com/docs/methods/oauth2/oauth2-quickstart\">Hubspot docs</a> if you need help finding this secret.", "type": "string", "examples": ["secret"], "airbyte_secret": true}, "refresh_token": {"title": "Refresh Token", "description": "Refresh token to renew an expired access token. See the <a href=\"https://legacydocs.hubspot.com/docs/methods/oauth2/oauth2-quickstart\">Hubspot docs</a> if you need help finding this token.", "type": "string", "examples": ["refresh_token"], "airbyte_secret": true}}}, {"type": "object", "title": "Private App", "required": ["access_token", "credentials_title"], "properties": {"credentials_title": {"type": "string", "title": "Auth Type", "description": "Name of the credentials set", "const": "Private App Credentials", "order": 0}, "access_token": {"title": "Access token", "description": "HubSpot Access token. See the <a href=\"https://developers.hubspot.com/docs/api/private-apps\">Hubspot docs</a> if you need help finding this token.", "type": "string", "airbyte_secret": true}}}]}, "enable_experimental_streams": {"title": "Enable experimental streams", "description": "If enabled then experimental streams become available for sync.", "type": "boolean", "default": false}, "num_worker": {"type": "integer", "title": "Number of concurrent workers", "minimum": 1, "maximum": 40, "default": 10, "examples": [1, 2, 3], "description": "The number of worker threads to use for the sync."}}}, "supportsNormalization": false, "supportsDBT": false, "advanced_auth": {"auth_flow_type": "oauth2.0", "predicate_key": ["credentials", "credentials_title"], "predicate_value": "OAuth Credentials", "oauth_config_specification": {"complete_oauth_output_specification": {"type": "object", "additionalProperties": false, "properties": {"refresh_token": {"type": "string", "path_in_connector_config": ["credentials", "refresh_token"]}}}, "complete_oauth_server_input_specification": {"type": "object", "additionalProperties": false, "properties": {"client_id": {"type": "string"}, "client_secret": {"type": "string"}}}, "complete_oauth_server_output_specification": {"type": "object", "additionalProperties": false, "properties": {"client_id": {"type": "string", "path_in_connector_config": ["credentials", "client_id"]}, "client_secret": {"type": "string", "path_in_connector_config": ["credentials", "client_secret"]}}}}}}, "tombstone": false, "public": true, "custom": false, "releaseStage": "generally_available", "supportLevel": "certified", "resourceRequirements": {"jobSpecific": [{"jobType": "check_connection", "resourceRequirements": {"memory_request": "1600Mi", "memory_limit": "1600Mi"}}, {"jobType": "discover_schema", "resourceRequirements": {"memory_request": "1024Mi", "memory_limit": "1024Mi"}}]}, "allowedHosts": {"hosts": ["api.hubapi.com"]}, "suggestedStreams": {"streams": ["contacts", "companies", "deals"]}, "maxSecondsBetweenMessages": 86400, "erdUrl": "https://dbdocs.io/airbyteio/source-hubspot?view=relationships", "releases": {"rolloutConfiguration": {"enableProgressiveRollout": false, "initialPercentage": 0, "maxPercentage": 50, "advanceDelayMinutes": 10}, "breakingChanges": {"2.0.0": {"upgradeDeadline": "2024-01-15", "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"}, "3.0.0": {"upgradeDeadline": "2024-02-12", "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": [{"scopeType": "stream", "impactedScopes": ["marketing_emails"]}]}, "4.0.0": {"upgradeDeadline": "2024-03-10", "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": [{"scopeType": "stream", "impactedScopes": ["deals_property_history", "companies_property_history"]}]}, "5.0.0": {"upgradeDeadline": "2025-06-15", "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.", "deadlineAction": "auto_upgrade", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#5.0.0", "scopedImpact": [{"scopeType": "stream", "impactedScopes": ["contact_lists", "contacts_form_submissions", "contacts_list_memberships", "contacts_merged_audit"]}]}, "6.0.0": {"upgradeDeadline": "2025-09-30", "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.", "deadlineAction": "auto_upgrade", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations#6.0.0", "scopedImpact": [{"scopeType": "stream", "impactedScopes": ["marketing_emails"]}]}}, "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/hubspot-migrations"}, "ab_internal": {"sl": 300, "ql": 400, "isEnterprise": false, "requireVersionIncrementsInPullRequests": true}, "generated": {"git": {"commit_sha": "8e5fdebde699bc1e7b7621caba8754bdd80e6764", "commit_timestamp": "2026-03-16T19:13:07+00:00", "commit_author": "Devin AI", "commit_author_email": "158243242+devin-ai-integration[bot]@users.noreply.github.com"}, "source_file_info": {"metadata_file_path": "metadata/airbyte/source-hubspot/6.3.1-preview.8e5fdeb/metadata.yaml", "metadata_bucket_name": "prod-airbyte-cloud-connector-metadata-service", "metadata_last_modified": "2026-03-16T19:22:05.377000+00:00", "registry_entry_generated_at": "2026-03-16T19:23:21.154417"}, "sbomUrl": "https://connectors.airbyte.com/files/sbom/airbyte/source-hubspot/6.3.1-preview.8e5fdeb.spdx.json"}, "packageInfo": {}, "language": "manifest-only", "supportsFileTransfer": false, "supportsDataActivation": false, "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"}}]}], "connectorBuildOptions": {"baseImage": "docker.io/airbyte/source-declarative-manifest:7.10.1@sha256:bd69f6b52bdd92ce06c30786d67546427b828ffb553363c8950b2816c552d6e0"}, "githubIssueLabel": "source-hubspot", "tags": ["language:manifest-only", "cdk:low-code"], "license": "ELv2", "remoteRegistries": {"pypi": {"enabled": false, "packageName": "airbyte-source-hubspot"}}, "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/"}]}