​
Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​
Pre-built tooling

ToolsStatus
Pre-built authorization (OAuth)✅
Credentials auto-refresh✅
Auth parameters validation✅
Pre-built authorization UI✅
Custom authorization UI✅
End-user authorization guide✅
Expired credentials detection✅
ToolsStatus
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✅
ToolsStatus
HTTP request logging✅
End-to-type type safety✅
Data runtime validation✅
OpenTelemetry export✅
Slack alerts on errors✅
Integration status API✅
ToolsStatus
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

EndpointDescriptionReadme
GET /accountsFetch account list and user information from Basecamp🔗
EndpointDescriptionReadme
GET /projectsFetch all projects from Basecamp🔗
EndpointDescriptionReadme
GET /todolistsFetch 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.🔗
EndpointDescriptionReadme
POST /todosCreate 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 /todosSyncs 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-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup here.
Paid test account✅ Not requiredCreate 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
TopicLinks
GeneralWebsite
Create a test account
DeveloperAPI 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 (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 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