Basecamp projects are not syncing. Help!

Most Common Problems

Synchronization Settings
Preferred Projects Selected for Syncing
Basecamp Permissions (including multiple logins)
Not Everything Syncs Back to Basecamp
Basecamp 2 Authentication
Basecamp Classic API Token

Less Common Problems

Project Deleted in Basecamp & New Project with Same Name Created in Basecamp
Canceled Basecamp Account


Synchronization Settings

In Roadmap go to Connecting Applications > Basecamp and confirm the desired Synchronization Setting is selected:


Using the browser extension will increase automatic (background) sync frequency. You can also manually import / export projects at any time in-bulk by going to the Projects Tab, clicking the Basecamp logo and selecting import or export.

Return to top

Preferred Projects Selected for Syncing

Go to Select Basecamp Projects and choose:

  • Sync All. Automatically includes new projects as they are created in Basecamp.
  • Sync Selected. New projects created in Basecamp not automatically included. Select "Save Changes" so the system will remember the changes. If the project you're looking for is not listed, then the Basecamp credentials used to integrate with Roadmap do not have access to the project in Basecamp.


Note: If you delete a project in Roadmap that was imported from Basecamp, it will be marked as excluded (so that it doesn't "show up" again in Roadmap). Projects marked as excluded will have a red X in their checkbox. Roadmap admins can clear this exclusion.

Return to top

Basecamp Permissions (including multiple logins)

Roadmap syncs with Basecamp using the credentials of a single Basecamp user. We recommend that this user be the Basecamp Account Owner. If the Basecamp user -- whose credentials were used to integrate with Roadmap -- does not have access to the project in Basecamp, then Roadmap will not "know" about the project.

If you have multiple logins (identities) for your Basecamp account, take note of which of those Basecamp identities you are logged into when integrating with Roadmap. If you are the Basecamp account owner, be sure to use that identity when integrating with Roadmap.

Return to top

Not Everything Syncs Back to Basecamp

Remember that not every Roadmap attribute gets exported to Basecamp. For example, resource allocation (time) estimates and custom project attributes are not exported to Basecamp; and only one resource assigned to a milestone -- the flagged one -- is exported.

Return to top

Basecamp 2 Authentication

It's possible that an anomaly has disrupted authentication between Roadmap and Basecamp. To re-establish the connection:


Return to top

Basecamp Classic API Token

It's possible that the Basecamp Classic API Token used by Roadmap has been regenerated. To confirm:

  • In Basecamp Classic, go to "My Info", scroll down and click "Show your tokens"


  • In Roadmap, go to Connecting Applications > Basecamp and confirm the tokens match. If not, update Roadmap with the correct token.

A less common problem is that your Basecamp Classic site address has changed, and thus Roadmap needs to be updated.

Return to top

Project Deleted in Basecamp; and New Project with the Same Name Created in Basecamp

From Roadmap's perspective, the original project does not exist and the new one is not in Roadmap because it was not automatically detected, because:

  • Roadmap has not imported from Basecamp since the delete-and-create activities occurred, or
  • Basecamp integration is not set to Sync All (i.e. only selected projects are being imported) so the new one was not automatically detected by Roadmap
Return to top

Canceled Basecamp Account

The final item to mention (it's happened more than once :)) is that synchronization will fail if your Basecamp account has been canceled (even unintentionally, or by someone else in your organization).

Return to top

Feedback and Knowledge Base