Advanced Analytica Advanced Analytica: IBOM
← All connectors
Basecamp logo

Source connector

Basecamp

Set up Basecamp as a source and move its data into your chosen destination.

Version 0.0.59 community alpha

Basecamp

Sync project, schedule, to-do and message data from Basecamp 3 to your destination. This page explains how to configure the Basecamp source connector. The connector uses the Basecamp 3 REST API and authenticates through 37signals Launchpad using OAuth 2.0.

Before you start

  • A Basecamp account on Basecamp 3. Basecamp 2 and Basecamp Classic use a different API and aren’t supported.
  • Your Basecamp Account ID.
  • A registered OAuth integration on 37signals Launchpad, which provides a Client ID and Client secret.
  • A long-lived OAuth 2.0 Refresh token issued for that integration.

Find your Account ID

Sign in to Basecamp and open any page in your account. Your account ID is the numeric segment immediately after the host in the URL. For example, if the URL is https://3.basecamp.com/1234567/projects, your account ID is 1234567. Basecamp scopes all API requests to this ID.

Register an OAuth integration

  1. Go to 37signals Launchpad integrations and click New integration.
  2. Enter a name, your company, and a website or contact address. 37signals uses these details to contact integration owners, so provide an address where you can receive mail.
  3. For Redirect URI, enter any URL you control. The connector doesn’t use this URL, but 37signals requires one. If you don’t have one available, use a placeholder such as https://example.com/oauth.
  4. Save the integration. Launchpad displays a Client ID and Client secret. Store both values safely. You’ll need them for the connector and to complete the OAuth flow.

Get a refresh token

You must provide a refresh token when you first set up the source. The connector then refreshes its own access tokens at runtime. Complete one full OAuth 2.0 authorisation code flow through 37signals Launchpad. Use the client ID and secret you created.

Follow the Basecamp authentication guide to exchange an authorisation code for an access token and refresh token. Use these endpoints:

  • Authorization: https://launchpad.37signals.com/authorization/new
  • Token exchange: https://launchpad.37signals.com/authorization/token

You can complete this flow with any OAuth 2.0 client library. Alternatively, the community-maintained basecampy3 CLI guides you through the flow and prints the resulting tokens. Record the refresh_token value. Airbyte needs this value.

You can reuse the same value across syncs. Refresh tokens from 37signals don’t expire unless you revoke the integration.

Set up the connector

  1. In the Airbyte UI, create a new Basecamp source.
  2. Enter your Account ID.
  3. Enter a Start date in YYYY-MM-DDTHH:MM:SSZ format. Incremental streams only emit records updated on or after this date.
  4. Paste the Client ID, Client secret, and Refresh token you obtained above into the matching fields.
  5. Click Set up source. Airbyte checks the connection against the projects endpoint to validate your credentials.

Configuration

InputTypeDescriptionDefault Value
account_idnumberYour Basecamp Account ID.
start_datestringStart date used for incremental streams. Records updated before this date aren’t synced.
client_idstringOAuth application Client ID from 37signals Launchpad.
client_secretstringOAuth application Client secret.
client_refresh_token_2stringOAuth 2.0 refresh token obtained by completing the Launchpad authorization flow once.

Supported sync modes

The Basecamp source connector supports these sync modes:

  • Full Refresh | Overwrite
  • Full Refresh | Append
  • Incremental | Append (for streams that expose an updated_at cursor)
  • Incremental | Append + Deduped (for streams that expose an updated_at cursor)

Supported streams

StreamPrimary keyIncrementalNotes
projectsid❌Active projects (buckets) in the account. Used as the parent stream for schedules.
schedulesid❌Schedule tools attached to each project.
schedule_entriesid❌Events listed in each project’s schedule.
todosid✅ (cursor: updated_at)To-do recordings across all projects.
messagesid✅ (cursor: updated_at)Message board posts across all projects.

The todos and messages streams use Basecamp’s projects/recordings.json endpoint. It returns records sorted by updated_at in descending order. The connector processes results until it reaches the configured start date, then stops. Basecamp doesn’t provide a server-side updated_since filter for this endpoint.

Performance

  • Basecamp applies dynamic, multi-dimensional rate limits. The first limit you’ll typically encounter is around 50 requests per 10-second window per IP. The connector retries 429 Too Many Requests responses using the Retry-After header.
  • All requests apply to one account. The connector’s url_base is https://3.basecampapi.com/{account_id}/.
  • Create one Airbyte source for each Basecamp account you want to sync.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.0.592026-11-1091359Update dependencies
0.0.582026-11-0390471Update dependencies
0.0.572026-10-2789806Update dependencies
0.0.562026-10-2089110Update dependencies
0.0.552026-10-1388511Update dependencies
0.0.542026-10-0888363Replace the default Airbyte icon with the Basecamp logo
0.0.532026-10-0687773Update dependencies
0.0.522026-09-2987071Update dependencies
0.0.512026-09-2286516Update dependencies
0.0.502026-09-1585972Update dependencies
0.0.492026-09-0885390Update dependencies
0.0.482026-08-1884494Update dependencies
0.0.472026-08-1183829Update dependencies
0.0.462026-08-0483358Update dependencies
0.0.452026-07-2882830Update dependencies
0.0.442026-07-2182310Update dependencies
0.0.432026-07-1481736Update dependencies
0.0.422026-06-3080974Update dependencies
0.0.412026-06-2380375Update dependencies
0.0.402026-06-1679765Update dependencies
0.0.392026-06-0979215Update dependencies
0.0.382026-06-0278583Update dependencies
0.0.372026-04-2877177Update dependencies
0.0.362026-04-2176843Bump SDM base image to stable 7.17.2
0.0.352026-03-3175947Bump SDM base image for memory monitor (CDK PR #962)
0.0.342026-03-3175892Update dependencies
0.0.332026-03-1775000Update dependencies
0.0.322026-02-2473800Update dependencies
0.0.312026-02-0372685Update dependencies
0.0.302026-01-2071898Update dependencies
0.0.292026-01-1471405Update dependencies
0.0.282025-12-1870811Update dependencies
0.0.272025-11-2569901Update dependencies
0.0.262025-11-1869521Update dependencies
0.0.252025-10-2968904Update dependencies
0.0.242025-10-2168382Update dependencies
0.0.232025-10-1467965Update dependencies
0.0.222025-10-0767162Update dependencies
0.0.212025-09-3066275Update dependencies
0.0.202025-09-0965643Update dependencies
0.0.192025-08-0264408Update dependencies
0.0.182025-07-2663806Update dependencies
0.0.172025-07-1263042Update dependencies
0.0.162025-06-2862136Update dependencies
0.0.152025-06-1561088Update dependencies
0.0.142025-05-2460678Update dependencies
0.0.132025-05-1059871Update dependencies
0.0.122025-05-0359362Update dependencies
0.0.112025-04-2658726Update dependencies
0.0.102025-04-1958254Update dependencies
0.0.92025-04-1257606Update dependencies
0.0.82025-04-0557157Update dependencies
0.0.72025-03-2956608Update dependencies
0.0.62025-03-2256114Update dependencies
0.0.52025-03-0854863Update dependencies
0.0.42025-02-2254222Update dependencies
0.0.32025-02-1547905Update dependencies
0.0.22024-10-0946660Update dependencies
0.0.12024-08-12Initial release by natikgadzhi via Connector Builder
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.