Basecamp

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Accounts

Function name	Description	Type	Source code
fetch-accounts	Fetch account list and user information from Basecamp	Action	🔗 Github

Projects

Function name	Description	Type	Source code
fetch-projects	Fetch all projects from Basecamp	Action	🔗 Github

Todolists

Function name	Description	Type	Source code
fetch-todolists	Fetch all todolists in a project.Fetch your projects via the fetch-projects action, then locate the project’s dock item where “name”: “todoset”. The id there is your todoSetId.	Action	🔗 Github

Todos

Function name	Description	Type	Source code
create-todo	Create a new to-do in a specific project + list. Fetch your todolists via the fetch-todolists action. Identify the list you want to add the todo to and retrieve the id from there.	Action	🔗 Github
todos	Syncs to-dos from Basecamp for the specified projects. Example of a metadata input Example: { projects: [ { projectId: 1234, todoSetId: 9999 }, ... ] }	Sync	🔗 Github

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	✅ Not required	Free, self-signup here.
Paid test account	✅ Not required	Create free account for testing.
Partnership	✅ Not required
App review	✅ Not required
Security audit	✅ Not required

Setup guide

1. Create a free account

   Go to Basecamp’s signup page and create an account.

2. Create & configure a Basecamp app

   • Start creating a Basecamp app by heading to the following page.
   • Click Register another application to open the application registration form.
   • Fill in the About section and configure the Redirect URL as follows: https://api.nango.dev/oauth/callback.
   • Select the products your app integrates with.
   • Submit Your Application.
   • Once your application has been created, navigate to the specific app page and copy the Client ID and Client Secret. You will need to specify these in Nango later.
3. Next

   Follow the Quickstart.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Topic	Links
General	Website
	Create a test account
Developer	API documentation
	Authorization documentation
	Register an OAuth app
	Details on rate limits

Contribute useful links by editing this page

API gotchas

• When creating a new connection in Nango, you will need to add the appDetails, configuration parameter in the format MyApp ([e-mail]), which will be appended to the request as a header: User-Agent: MyApp ([e-mail]). This information will be used to get in touch if you’re doing something wrong(so the provider can warn you before you’re blocked) or something awesome (so the provider can congratulate you). Requests without a valid User-Agent header are rejected.
• You will also need to add in your accountId connection configuration parameter.
  Contribute API gotchas by editing this page

Going further

Connect to Basecamp

Guide to connect to Basecamp using Connect UI