Reference
Basecamp
Set up Basecamp OAuth for project management and team collaboration
Overview
Section titled “Overview”Connect your users to Basecamp for project management, team collaboration, and task tracking.
| Property | Value |
|---|---|
| Provider ID | basecamp |
| Category | Productivity |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Basecamp OAuth App
Section titled “Step 1: Create a Basecamp OAuth App”Go to 37signals Launchpad
Navigate to 37signals Launchpad and sign in with your Basecamp account.
Register a new application
Click Register another application.
Configure the application
Enter the application name and company website. Add the Alter callback URL (from the Developer Portal) to the Redirect URI field.
Get credentials
Copy the Client ID and Client Secret.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Basecamp provider
Go to OAuth Providers > Add Provider > Basecamp.
Enter credentials
- Client ID: Paste your Basecamp Client ID
- Client Secret: Paste your Basecamp Client Secret
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”Basecamp does not use OAuth scopes. The access token grants access based on the authenticating user’s permissions within their Basecamp account.
- The OAuth flow goes through 37signals Launchpad, the parent company of Basecamp.
- Basecamp does not use scopes. Tokens grant access to all Basecamp resources the authenticating user has permission to access.
- See the Basecamp API documentation for more details on authentication and available endpoints.
Policy-cataloged operations
Section titled “Policy-cataloged operations”Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.
| Operation ID | Families | Method | Provider path |
|---|---|---|---|
comments/create | send | POST | /buckets/{bucket_id}/recordings/{recording_id}/comments.json |
todos/uncomplete | delete | DELETE | /buckets/{bucket_id}/todos/{todo_id}/completion.json |
documents/create | write | POST | /buckets/{bucket_id}/vaults/{vault_id}/documents.json |
messages/create | write | POST | /buckets/{bucket_id}/message_boards/{board_id}/messages.json |
projects/create | write | POST | /projects.json |
schedule-entries/create | write | POST | /buckets/{bucket_id}/schedules/{schedule_id}/entries.json |
todolists/create | write | POST | /buckets/{bucket_id}/todosets/{todoset_id}/todolists.json |
todos/complete | write | POST | /buckets/{bucket_id}/todos/{todo_id}/completion.json |
todos/create | write | POST | /buckets/{bucket_id}/todolists/{todolist_id}/todos.json |
chats/list | read | GET | /chats.json |
comments/list | read | GET | /buckets/{bucket_id}/recordings/{recording_id}/comments.json |
documents/list | read | GET | /buckets/{bucket_id}/vaults/{vault_id}/documents.json |
messages/list | read | GET | /buckets/{bucket_id}/message_boards/{board_id}/messages.json |
my/profile | read | GET | /my/profile.json |
people/list | read | GET | /people.json |
projects/list | read | GET | /projects.json |
projects/people | read | GET | /projects/{project_id}/people.json |
schedule-entries/list | read | GET | /buckets/{bucket_id}/schedules/{schedule_id}/entries.json |
todolists/list | read | GET | /buckets/{bucket_id}/todosets/{todoset_id}/todolists.json |
todos/list | read | GET | /buckets/{bucket_id}/todolists/{todolist_id}/todos.json |