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

Jira

Asana

Teamleader

Clickup

Freshbooks

Trello Connector

Zoho Books

# Update Project

This scenario allows your application to update a Project in any external application in the same way. 
You will pass  ID of the Project you want to update and Project fields in any format your application support and Integration.app will handle mapping of them to the schema of any selected application.
Additionally, if needed, your customers can customize the data mapping based on their specific setup.

## How It Works

1. **Configuration**:
   - You will setup the schema of fields that you wish to update Project with and configure mapping to our default model

2. **Create Project API call**:
   - Call Integration.app REST API or SDK with payload matching the field mapping you configured and ID. You can run it for any external application via the same request.
   - When called, Integration.app transforms your Project data into a format compatible with the selected external application.
   - It then makes an API call to update the Project in that specific application.


Update Project

Updates Project in any external application

# Delete Project

This scenario allows your application to delete a Project from any external application. 
You will pass ID of the Project you want to delete and Integration.app will handle the rest.

## How It Works

1. **Delete Project API call**:
   - Call Integration.app REST API or SDK with ID of the Project you want to delete and Integration.app will send the correct request to the external app.


Delete Project

Deletes Project in any external application

# Create Project

This scenario allows your application to create a Project in any external application in the same way. 
You will pass Project fields in any format your application support and Integration.app will handle mapping of them to the schema of any selected application.
Additionally, if needed, your customers can customize the data mapping based on their specific setup.


## How It Works

1. **Configuration**:
   - You will setup the schema of fields that you wish to create Project with and configure mapping to our default model

2. **Create Project API call**:
   - Call Integration.app REST API or SDK with payload matching the field mapping you configured. You can run it for any external application via the same request.
   - When called, Integration.app transforms your Project data into a format compatible with the selected external application.
   - It then makes an API call to create the Project in that specific application.


Create Project

Creates Project in any external application

# Get all Projects

This scenario enables your application to get a complete list of Projects from any external application to your app's API in the same way. 

When receiving Projects 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

You will call a Integration.app REST API endpoint or SDK methods to retrieve a single page of Projects along with the `cursor` if next page is available.
Repeate this request in a loop from your code to retrieve all Projects page by page.


Get all Projects

Imports all Projects from any external application to your App.

Microsoft Sharepoint

HubSpot

Salesforce

Zoho CRM

Pipedrive

# Create User

This scenario allows your application to create a User in any external application in the same way. 
You will pass User fields in any format your application support and Integration.app will handle mapping of them to the schema of any selected application.
Additionally, if needed, your customers can customize the data mapping based on their specific setup.


## How It Works

1. **Configuration**:
   - You will setup the schema of fields that you wish to create User with and configure mapping to our default model

2. **Create User API call**:
   - Call Integration.app REST API or SDK with payload matching the field mapping you configured. You can run it for any external application via the same request.
   - When called, Integration.app transforms your User data into a format compatible with the selected external application.
   - It then makes an API call to create the User in that specific application.


	Users automatically maps to	Projects automatically maps to
Clickup	Workspace Users	Lists
Asana	Users	Projects
Jira	Users	Projects
Teamleader	Users	Projects
Insightly	Users	Projects
Zoho Books	Users	Projects
Teamwork	—	Projects
Github	Users	—
Notion	Users	—
Zendesk	Users	—

Basecamp API Integration Profile

Getting Started

Data Collections

Operations

Integration Scenarios

Works with:

Works with:

Works with:

Works with:

Works with:

Works with:

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

Users

Projects

Supercharge your product integrations today

Basecamp API Integration Profile

Getting Started

Data Collections

Operations

Integration Scenarios

Works with:

Works with:

Works with:

Works with:

Works with:

Works with:

Use the same code to integrate with Basecamp and 100+ other applicationsself.__wrap_n!=1&&self.__wrap_b(":R2p7il6:",1)

Users

Projects

Supercharge your product integrations today

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