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
- Go to 37signals Launchpad integrations and click New integration.
- 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.
- 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. - 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
- In the Airbyte UI, create a new Basecamp source.
- Enter your Account ID.
- Enter a Start date in
YYYY-MM-DDTHH:MM:SSZformat. Incremental streams only emit records updated on or after this date. - Paste the Client ID, Client secret, and Refresh token you obtained above into the matching fields.
- Click Set up source. Airbyte checks the connection against the
projectsendpoint to validate your credentials.
Configuration
| Input | Type | Description | Default Value |
|---|---|---|---|
account_id | number | Your Basecamp Account ID. | |
start_date | string | Start date used for incremental streams. Records updated before this date aren’t synced. | |
client_id | string | OAuth application Client ID from 37signals Launchpad. | |
client_secret | string | OAuth application Client secret. | |
client_refresh_token_2 | string | OAuth 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_atcursor) - Incremental | Append + Deduped (for streams that expose an
updated_atcursor)
Supported streams
| Stream | Primary key | Incremental | Notes |
|---|---|---|---|
projects | id | ❌ | Active projects (buckets) in the account. Used as the parent stream for schedules. |
schedules | id | ❌ | Schedule tools attached to each project. |
schedule_entries | id | ❌ | Events listed in each project’s schedule. |
todos | id | ✅ (cursor: updated_at) | To-do recordings across all projects. |
messages | id | ✅ (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 Requestsresponses using theRetry-Afterheader. - All requests apply to one account. The connector’s
url_baseishttps://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
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.59 | 2026-11-10 | 91359 | Update dependencies |
| 0.0.58 | 2026-11-03 | 90471 | Update dependencies |
| 0.0.57 | 2026-10-27 | 89806 | Update dependencies |
| 0.0.56 | 2026-10-20 | 89110 | Update dependencies |
| 0.0.55 | 2026-10-13 | 88511 | Update dependencies |
| 0.0.54 | 2026-10-08 | 88363 | Replace the default Airbyte icon with the Basecamp logo |
| 0.0.53 | 2026-10-06 | 87773 | Update dependencies |
| 0.0.52 | 2026-09-29 | 87071 | Update dependencies |
| 0.0.51 | 2026-09-22 | 86516 | Update dependencies |
| 0.0.50 | 2026-09-15 | 85972 | Update dependencies |
| 0.0.49 | 2026-09-08 | 85390 | Update dependencies |
| 0.0.48 | 2026-08-18 | 84494 | Update dependencies |
| 0.0.47 | 2026-08-11 | 83829 | Update dependencies |
| 0.0.46 | 2026-08-04 | 83358 | Update dependencies |
| 0.0.45 | 2026-07-28 | 82830 | Update dependencies |
| 0.0.44 | 2026-07-21 | 82310 | Update dependencies |
| 0.0.43 | 2026-07-14 | 81736 | Update dependencies |
| 0.0.42 | 2026-06-30 | 80974 | Update dependencies |
| 0.0.41 | 2026-06-23 | 80375 | Update dependencies |
| 0.0.40 | 2026-06-16 | 79765 | Update dependencies |
| 0.0.39 | 2026-06-09 | 79215 | Update dependencies |
| 0.0.38 | 2026-06-02 | 78583 | Update dependencies |
| 0.0.37 | 2026-04-28 | 77177 | Update dependencies |
| 0.0.36 | 2026-04-21 | 76843 | Bump SDM base image to stable 7.17.2 |
| 0.0.35 | 2026-03-31 | 75947 | Bump SDM base image for memory monitor (CDK PR #962) |
| 0.0.34 | 2026-03-31 | 75892 | Update dependencies |
| 0.0.33 | 2026-03-17 | 75000 | Update dependencies |
| 0.0.32 | 2026-02-24 | 73800 | Update dependencies |
| 0.0.31 | 2026-02-03 | 72685 | Update dependencies |
| 0.0.30 | 2026-01-20 | 71898 | Update dependencies |
| 0.0.29 | 2026-01-14 | 71405 | Update dependencies |
| 0.0.28 | 2025-12-18 | 70811 | Update dependencies |
| 0.0.27 | 2025-11-25 | 69901 | Update dependencies |
| 0.0.26 | 2025-11-18 | 69521 | Update dependencies |
| 0.0.25 | 2025-10-29 | 68904 | Update dependencies |
| 0.0.24 | 2025-10-21 | 68382 | Update dependencies |
| 0.0.23 | 2025-10-14 | 67965 | Update dependencies |
| 0.0.22 | 2025-10-07 | 67162 | Update dependencies |
| 0.0.21 | 2025-09-30 | 66275 | Update dependencies |
| 0.0.20 | 2025-09-09 | 65643 | Update dependencies |
| 0.0.19 | 2025-08-02 | 64408 | Update dependencies |
| 0.0.18 | 2025-07-26 | 63806 | Update dependencies |
| 0.0.17 | 2025-07-12 | 63042 | Update dependencies |
| 0.0.16 | 2025-06-28 | 62136 | Update dependencies |
| 0.0.15 | 2025-06-15 | 61088 | Update dependencies |
| 0.0.14 | 2025-05-24 | 60678 | Update dependencies |
| 0.0.13 | 2025-05-10 | 59871 | Update dependencies |
| 0.0.12 | 2025-05-03 | 59362 | Update dependencies |
| 0.0.11 | 2025-04-26 | 58726 | Update dependencies |
| 0.0.10 | 2025-04-19 | 58254 | Update dependencies |
| 0.0.9 | 2025-04-12 | 57606 | Update dependencies |
| 0.0.8 | 2025-04-05 | 57157 | Update dependencies |
| 0.0.7 | 2025-03-29 | 56608 | Update dependencies |
| 0.0.6 | 2025-03-22 | 56114 | Update dependencies |
| 0.0.5 | 2025-03-08 | 54863 | Update dependencies |
| 0.0.4 | 2025-02-22 | 54222 | Update dependencies |
| 0.0.3 | 2025-02-15 | 47905 | Update dependencies |
| 0.0.2 | 2024-10-09 | 46660 | Update dependencies |
| 0.0.1 | 2024-08-12 | Initial release by natikgadzhi via Connector Builder |