Looking to integrate with a Basecamp product? We've got everything you need here. From sample code to detailed API documentation, you'll be up and running in no time. (We just encourage you to have realistic expectations regarding the continued evolution of these APIs).
Where do I start?
Want to get started with API integration? Here's a quick check list:
- Review our Terms of Service, in particular the Services Adaptations and API Terms section and our Use Restrictions.
- Register your app or update your already registered app to access more products.
- Review the brand guidelines for rules on naming and marketing your app.
- Read up on how to authenticate your app with our products.
- Peruse the API docs for the product you need to work with.
- Have a question? Post it on StackOverflow tagged with the product you're working on (for example,
basecamp) or open up a support ticket.
Need to look up the API documentation for a product? There's a repo for each:
Logging your users into our products is supported through OAuth 2. Several apps support login via API tokens and HTTP Basic Authentication as well.
We have a detailed guide for authenticating your users with our apps.
The Basecamp APIs aren't intended to be complete models of everything you can do in all our applications. The truth is that less than half a percent of our end-users take advantage of applications that integrate with Basecamp or write their own integrations. Such low usage means that continuing to update the API to stay in sync with all new features is not a high priority at Basecamp. When we do work for that less than that one half of a percent of users, we're not helping that other 99.5%.
We still do make upgrades and improvements from time to time, and if you find a bug in the APIs we do have exposed, please open a support ticket. Also, feel free to fork these docs and send a pull request with improvements!