Skip to main content

Intercom

This page guides you through the process of setting up the Intercom source connector.

Set up the Intercom connector​

  1. Log into your Airbyte Cloud or Airbyte Open Source account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Intercom from the Source type dropdown.
  4. Enter a name for your source.
  5. For Start date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated. If this field is blank, Airbyte will replicate all data.
  6. For Airbyte Cloud, click Authenticate your Intercom account to sign in with Intercom and authorize your account. For Airbyte Open Source, enter your Access Token to authenticate your account.
  7. Click Set up source.

Supported sync modes​

The Intercom source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Supported Streams​

The Intercom source connector supports the following streams:

Performance considerations​

The connector is restricted by normal Intercom requests limitation.

The Intercom connector should not run into Intercom API limitations under normal usage. Create an issue if you see any rate limit issues that are not automatically retried successfully.

Changelog​

VersionDatePull RequestSubject
0.2.12023-05-2526571Remove authSpecification from spec.json in favour of advancedAuth
0.2.02023-04-0523013Migrated to Low-code (YAML Frramework)
0.1.332023-03-2022980Specified date formatting in specification
0.1.322023-02-2722095Extended Contacts schema adding opted_out_subscription_types property
0.1.312023-02-1723152Add TypeTransformer to stream companies
0.1.302023-01-2722010Set AvailabilityStrategy for streams explicitly to None
0.1.292022-10-3118681Define correct version for airbyte-cdk~=0.2
0.1.282022-10-2018216Use airbyte-cdk~=0.2.0 with SQLite caching
0.1.272022-08-2817326Migrate to per-stream states.
0.1.262022-08-1816540Fix JSON schema
0.1.252022-08-1815681Update Intercom API to v 2.5
0.1.242022-07-2114924Remove additionalProperties field from schemas
0.1.232022-07-1914830Added checkpoint_interval for Incremental streams
0.1.222022-07-0914554Fixed conversation_parts stream schema definition
0.1.212022-07-0514403Refactored Conversations, Conversation Parts, Company Segments to increase performance
0.1.202022-06-2414099Extended Contacts stream schema with sms_consent,unsubscribe_from_sms properties
0.1.192022-05-2513204Fixed conversation_parts stream schema definition
0.1.182022-05-0412482Update input configuration copy
0.1.172022-04-2912374Fixed filtering of conversation_parts
0.1.162022-03-2311206Added conversation_id field to conversation_part records
0.1.152022-03-2211176Correct check_connection URL
0.1.142022-03-1611208Improve 'conversations' incremental sync speed
0.1.132022-01-149513Added handling of scroll param when it expired
0.1.122021-12-148429Updated fields and descriptions
0.1.112021-12-138685Remove time.sleep for rate limit
0.1.102021-12-108637Fix 'conversations' order and sorting. Correction of the companies stream
0.1.92021-12-038395Fix backoff of 'companies' stream
0.1.82021-11-097060Added oauth support
0.1.72021-11-087499Remove base-python dependencies
0.1.62021-10-076879Corrected pagination for contacts
0.1.52021-09-286082Corrected android_last_seen_at field data type in schemas
0.1.42021-09-206087Corrected updated_at field data type in schemas
0.1.32021-09-085908Corrected timestamp and arrays in schemas
0.1.22021-08-195531Corrected pagination
0.1.12021-07-315123Corrected rate limit
0.1.02021-07-194676Release Intercom CDK Connector