APIs & Integrations
Basecamp
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ 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
✅ 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
✅ 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 | ✅ |
Pre-built integrations
Accounts
Accounts
| Endpoint | Description | Readme |
|---|---|---|
GET /accounts | Fetch account list and user information from Basecamp | 🔗 |
Projects
Projects
| Endpoint | Description | Readme |
|---|---|---|
GET /projects | Fetch all projects from Basecamp | 🔗 |
Todolists
Todolists
| Endpoint | Description | Readme |
|---|---|---|
GET /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. | 🔗 |
Todos
Todos
| Endpoint | Description | Readme |
|---|---|---|
POST /todos | 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. | 🔗 |
GET /todos | Syncs to-dos from Basecamp for the specified projects. Example of a metadata input Example: { projects: [ { projectId: 1234, todoSetId: 9999 }, ... ] } | 🔗 |
Not seeing the integration you need? Build your own independently.
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 IDandClient 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 formatMyApp (yourname@example.com), which will be appended to the request as a header:User-Agent: MyApp (yourname@example.com). 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 validUser-Agentheader are rejected. - You will also need to add in your
accountIdconnection configuration parameter.Contribute API gotchas by editing this page
Going further
Connect to Basecamp
Guide to connect to Basecamp using Connect UI