Access Token

Refresh Token

Basecamp

_objects

People

Data

Projects

Recordings

Schedule Entries

Schedules

Todo Lists

Todo Sets

Returns a paginated list of active Templates visible to the current user sorted by most recently created Template first.

Get Templates

Creates a new Template with at least a `name`, and optionally a `description`.

Create a Template

Returns the Template with the given ID, granted they have access to it.

Get a Template

Allows updating of a Template's name and description.

Update a Template

Marks the Template with the given ID as trashed. Trashed Templates will be deleted from Basecamp after 30 days.

Trash a Template

Creates a project given a template by creating a project construction.

Create a Project Construction

Returns the project construction with the specified IDs.

Get a Project Construction

Returns all the webhooks from the basecamp with the specified bucket ID.

Get webhooks

Creates a webhook in the project with the specified bucket ID.

Create a webhook

Returns the webhook with the specified ID in the project with the specified bucket ID.

Get a webhook

Allows changing the payload URL and types of the webhook with the specified ID in the project with the specified bucket ID.

Update a webhook

Deletes the webhook with the specified ID in the project with the specified bucket ID.

Destroy a webhook

Returns a paginated list of vaults in the project with an ID of `1` and the vault with ID of `2`.

Get a list of vaults

Creates a vault in the project with ID `1` and under the vault with an ID of `2`.

Create a vault

Returns the vault with an ID of `2` in the project with an ID of `1`.

Get a single vault

Allows changing the title of the vault with an ID of `2` in the project with ID `1`.

Update a vault

Returns a paginated list of active uploads in the project with an ID of `1` and the vault with ID of `2`.

Get uploads

Creates an upload in the project with ID `1` and under the vault with an ID of `2`.

Create an upload

Returns the upload with an ID of `2` in the project with an ID of `1`.

Get an upload

Allows changing the `description` and `base_name` of the upload with an ID of `2` in the project with ID `1`.

Update an upload

Returns the to-do set for the project with the specified ID and to-do set ID.

Get to-do set

Returns a paginated list of active to-dos in the project with an ID of `1` and the to-do list with ID of `3`.

Get to-dos

Creates a to-do in the project with ID `1` and under the to-do list with an ID of `3`.

Create a to-do

Returns the to-do with an ID of `2` in the project with an ID of `1`.

Get a to-do

Allows changing the to-do with an ID of `2` in the project with ID `1`.

Update a to-do

Marks the to-do with an ID of `2` in the project with ID `1` as completed.

Complete a to-do

Marks the to-do with an ID of `2` in the project with ID `1` as uncompleted.

Uncomplete a to-do

Allows changing the position of the to-do with an ID of `2` in the project with ID `1`.

Reposition a to-do

Allows changing the title and content of the document with the specified ID in the project with the specified ID.

Update a document

Allows changing the title and content of the document with an ID of `2` in the project with ID `1`.

Publishes a document in the project with ID `1` and under the vault with an ID of `2`.

Publishes a document

Returns a paginated list of active documents in the project with an ID of `1` and the vault with ID of `2`.

List active documents

Returns the document with the specified ID within the specified bucket.

Get a specific document by ID

Adds and removes people from the list of subscribers for the specified recording in the specified bucket.

Update the list of subscribers for a recording

Unsubscribes the current user from the recording with the specified ID in the specified bucket. Returns `204 No Content` in any case, even if the current user wasn't previously subscribed.

Unsubscribe from a recording

POST /buckets/1/recordings/2/subscription.json will subscribe the current user to the recording with an ID of `2` in the bucket with ID `1`.

Subscribe the current user to the recording

Returns subscription information for a recording with a specific ID in the specified bucket.

Get subscription information for a recording

Retrieve information about current subscribers for a resource.

Get subscription

Allows changing the position of the to-do list group with an ID of `3` in the project with ID `1`.

Change the position of a to-do list group

Creates a to-do group within the todolist with ID `2` in the project with id `1`.

Create a to-do group within a specific to-do list

Returns a paginated list of active groups in the project with an ID of `1` and the to-do list with ID of `2`. Optional query parameters: `status` - when set to `archived` or `trashed`, returns only archived or trashed to-do list groups within this to-do list.

Get a paginated list of active to-do list groups

Returns the to-do list group with an ID of `3` in the project with an ID of `1`.

Get a to-do list group

List to-do list groups

Returns a paginated list of events for the recording with the specified ID in the project with the specified bucket ID.

List events for a recording

An event is created any time a recording changes.

Get events

Returns the card_table with an ID of `card_table_id` in the project with an ID of `bucket_id`.

Get a specific card table by ID

Get a card table

Creates a line in the Campfire with ID `2` in the project with ID `1`.

Creates a line in the Campfire

Returns the Campfire line with the specified ID in the Campfire with the specified ID in the project with the specified ID.

Get a Campfire line by ID

Returns a paginated list of Campfire lines of the Campfire with the specified ID in the project with the specified bucket ID.

Get a paginated list of Campfire lines

GET /buckets/1/chats/2.json will return the Campfire with ID `2` in the project with ID `1`.

Get Campfire by ID

Returns a paginated list of all active Campfires visible to the current user.

Get a paginated list of all active Campfires

Get Campfires

PUT /buckets/1/recordings/2/status/active.json will mark the recording with an ID of `2` in the project with ID `1` as active. No parameters required.

Mark a recording as active

Marks the recording with the specified ID in the project with the specified ID as archived.

Archive a recording

PUT /buckets/1/recordings/2/status/trashed will mark the recording with an ID of `2` in the project with ID `1` as trashed. No parameters required.

Mark a recording as trashed

Returns a paginated list of records for the given type of recording.

Get a paginated list of recordings

Get recordings

Returns the inbox with an ID of `inbox_id` for the project with an ID of `project_id`. To get the inbox ID for a project, see the Get a project endpoint's `dock` payload. To retrieve its forwards, see the Get forwards endpoint.

Get a specific inbox by ID for a project

Get inbox

Returns the inbox reply with an ID of `reply_id` for the forward with an ID of `forward_id` in the project with an ID of `project_id`.

Get a specific inbox reply

Returns a paginated list of inbox replies in the project with an ID of `1` and the forward with ID of `2`.

Get a paginated list of inbox replies

Allows changing the title of the vault with an ID of `3` in the project with ID `1`. This endpoint will return `200 OK` with the current JSON representation of the vault if the update was a success.

Update the title of a specific vault

Retrieves a list of inbox replies nested under the specified recording ID.

Get inbox replies

Returns the vault with an ID of `vault_id` in the project with an ID of `project_id`.

Get a specific vault by ID

Retrieve a list of vaults within the project.

Get vaults

DELETE /buckets/1/todos/2/completion.json will mark the to-do with an ID of `2` in the project with ID `1` as uncompleted. This endpoint will return `204 No Content` if successful. No parameters are required.

Mark a to-do as uncompleted

GET /buckets/1/todos/2.json will return the to-do with an ID of `2` in the project with an ID of `1`.

Get a specific to-do by ID

Returns the client correspondence with the specified ID in the project with the given ID.

Get a specific client correspondence

Returns a paginated list of client correspondences in the project with an ID of `1`.

Get a paginated list of client correspondences

Get client correspondences

DELETE /projects/1.json will mark the project with the given ID as trashed. Trashed projects will be deleted from Basecamp 4 after 30 days.

Mark a project as trashed

Allows updating of a project's name, description, schedule, and admissions policy.

Update a project's name and description

Creates a new project with a `name` and an optional `description`.

Create a new project

Returns a paginated list of active projects visible to the current user sorted by most recently created project first.

Get a paginated list of active projects

Returns the project with the given ID, granted the user has access to it.

Get a project by ID

Get all projects

Returns the answer with an ID of `2` in the project with an ID of `1`.

Get a specific answer by ID

Returns a paginated list of answers in the project with the specified `project_id` and for the question with `question_id`.

Get a paginated list of answers for a specific question in a project

Get question answers

Returns the forward with an ID of `2` in the project with an ID of `1`.

Get a specific inbox forward by ID

Returns a paginated list of active forwards in the project with an ID of `1` and the inbox with an ID of `3`.

Get a paginated list of active forwards

Get forwards

Returns the upload with an ID of `upload_id` in the project with an ID of `project_id`.

Get an upload by ID

Returns a paginated list of active uploads in the project with the specified ID and the vault with the specified ID.

Get a paginated list of active uploads

DELETE /buckets/1/webhooks/3.json will delete the webhook with an ID of `3` in the project with ID `1`. This endpoint will return `204 No Content` if the destroy was a success.

Delete a specific webhook

Allows changing the payload url and types of the webhook with an ID of `3` in the project with ID `1`.

Creates a webhook in the project with ID `1`.

Create a webhook in the project

Microsoft Sharepoint

Salesforce

HubSpot

Microsoft Dynamics 365

Zoho CRM

Pipedrive

Monday

Freshsales

Slack

Keap

Jira

SugarCRM

Asana

Outreach

Xero

ActiveCampaign

Capsule CRM

Github

Notion

Salesloft

Clickup

Agile CRM

SalesForce Pardot

SharpSpring

# Continuous Import of Users to Your App

This scenario enables your application to continuously sync Users from any external application to your app's API. It handles the initial import of Users and keeps them synchronized when a User is created, updated, or deleted in the external application.

When receiving Users data from the external application, the data is transformed into a format supported by your app's API. Additionally, if needed, your customers can customize the data mapping based on their specific external application setup.

## How It Works

1. **Initial Import**:
   - Perform the initial import by calling the Integration.app REST API or SDK in a loop from your code to retrieve data page by page.
   - Integration.app transforms the output into a consistent format compatible with your API, allowing you to save the data efficiently.

2. **Continuous Sync**:
   - Enable subscription via a single API or SDK call to continuously receive created, updated, or deleted events.
   - Integration.app manages all integration-specific logic, including subscribing to/unsubscribing from webhooks, custom polling of events, or performing periodic full syncs.
   - You will only receive the necessary events as real-time as supported by the external application's API.

Continuously Import Users to my App

Import Users and receive created/updated or deleted events

Basecamp API Integration Profile

Getting Started

Data Collections

Operations

Integration Scenarios

Continuously Import Users to my App

Update Project

Delete Project

Create Project

Get all Projects

Create User

Use the same code to integrate with Basecamp and 100+ other applications

Users

Projects

Build every single integration your customers need with AI

	Users automatically maps to	Projects automatically maps to
Clickup	Workspace Users	Lists
Jira	Users	Projects
Asana	Users	Projects
Teamleader	Users	Projects
Trello Connector	Members	Boards
Insightly	Users	Projects
Zoho Books	Users	Projects
Teamwork	—	Projects
Github	Users	—
Notion	Users	—