Basecamp 3 (Preview)

Basecamp 3 is a tool that helps teams work together. It provides a dashboard to manage all messaging, document collaboration, scheduling and task management together in one place.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Connector Metadata
Publisher Microsoft

Throttling Limits

Name Calls Renewal Period
API calls per connection3060 seconds
Frequency of trigger polls115 seconds

Actions

Complete a to-do

Mark a to-do as completed

Create a document

Add a document

Create a schedule entry

Create a schedule entry

Create a to-do

Add a to-do to a to-do list

Delete a document

Put a document in the trash

Delete a scheduled entry

Put a scheduled entry in the trash

Delete a to-do

Put a to-do in the trash

Delete an object [DEPRECATED]

Put an object in the trash

List Accounts

List Accounts you're a part of

List Basecamps

List Basecamps you're a part of

List to-do lists

List the to-do lists in the basecamp

List to-dos

List the to-dos in a to-do list

Post a message

Add a message to a basecamp

Uncomplete a to-do

Mark a to-do as not completed

Upload file

Upload a file

Complete a to-do

Mark a to-do as completed

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do Id
todoId True string

Get a To-do Id from a previous step

Create a document

Add a document

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Title
title True string

The title of the document

Content
content True string

The content of the document, formatted as HTML

Returns

A document object

Document
Document

Create a schedule entry

Create a schedule entry

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Summary
summary True string

A summarized description of the schedule entry

Start time
starts_at True date-time

Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:00.000Z)

End time
ends_at True date-time

Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:00.000Z)

Participants
participant_ids string

A comma separated list of participant email addresses

Returns

An entry to schedule

Schedule entry
Entry

Create a to-do

Add a to-do to a to-do list

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do list
todolistId True string

Unique identifier of the to-do list.

Content
content True string

What the to-do is for

Description
description string

A description of the to-do, formatted as HTML

Due on
due_on date-time

A due date when the to-do should be completed

Start on
start_on date-time

A date when the to-do should be started

Returns

A To-do from a To-do List

To-do
ToDo

Delete a document

Put a document in the trash

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Document Id
documentId True string

Get a document Id from a previous step

Delete a scheduled entry

Put a scheduled entry in the trash

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Scheduled entry Id
eventId True string

Get a scheduled entry Id from a previous step

Delete a to-do

Put a to-do in the trash

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do Id
todoId True string

Get a To-do Id from a previous step

Delete an object [DEPRECATED]

Put an object in the trash

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Object Id
objectId True string

Unique identifier of the object.

List Accounts

List Accounts you're a part of

Returns

A list of Accounts

Accounts
AccountList

List Basecamps

List Basecamps you're a part of

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Returns

A list of Basecamps

Items
BasecampList

List to-do lists

List the to-do lists in the basecamp

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
bucket string

Basecamp to filter on

Returns

The to-do lists in the Basecamp

To-do lists
array of ToDoList

List to-dos

List the to-dos in a to-do list

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do list
todolistId True string

Unique identifier of the to-do list.

Returns

The top 50 active items in the to-do list

To-dos
array of ToDo

Post a message

Add a message to a basecamp

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Subject
subject True string

The subject of the message

Content
content True string

The content of the message, formatted as HTML

Returns

A message posted to a basecamp

Message
Message

Uncomplete a to-do

Mark a to-do as not completed

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do Id
todoId True string

Get a To-do Id from a previous step

Upload file

Upload a file

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Content type
content_type True string

The content type of the file

File name
name True string

Name of the file being uploaded

File data
body True binary

The binary data of the file

Returns

A list of Basecamps

Items
BasecampList

Triggers

When a document is created

This operation triggers when a new document is created in Basecamp.

When a document is deleted

This operation triggers when a document is deleted in Basecamp.

When a document is updated

This operation triggers when a document is updated in Basecamp.

When a file is updated

This operation triggers when a file is updated in Basecamp.

When a file is uploaded

This operation triggers when a file is uploaded in Basecamp.

When a message is posted

This operation triggers when a new message is posted in Basecamp.

When a schedule entry is created

This operation triggers when a new schedule entry is created in Basecamp.

When a schedule entry is deleted

This operation triggers when a schedule entry is deleted in Basecamp.

When a schedule entry is updated

This operation triggers when a schedule entry is updated in Basecamp.

When a to-do is created

This operation triggers when a new to-do is created in Basecamp.

When a to-do is updated

This operation triggers when an existing to-do is updated in Basecamp.

When a document is created

This operation triggers when a new document is created in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Returns

A document object

Document
Document

When a document is deleted

This operation triggers when a document is deleted in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
bucket string

Basecamp to filter on

Returns

A document object

Document
Document

When a document is updated

This operation triggers when a document is updated in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Returns

A document object

Document
Document

When a file is updated

This operation triggers when a file is updated in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Returns

A file upload object

Upload
Upload

When a file is uploaded

This operation triggers when a file is uploaded in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Vault (folder)
vaultId True string

Select a folder or enter a vault Id

Returns

A file upload object

Upload
Upload

When a message is posted

This operation triggers when a new message is posted in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Returns

A message posted to a basecamp

Message
Message

When a schedule entry is created

This operation triggers when a new schedule entry is created in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Returns

An entry to schedule

Schedule entry
Entry

When a schedule entry is deleted

This operation triggers when a schedule entry is deleted in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
bucket string

Basecamp to filter on

Returns

An entry to schedule

Schedule entry
Entry

When a schedule entry is updated

This operation triggers when a schedule entry is updated in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

Returns

An entry to schedule

Schedule entry
Entry

When a to-do is created

This operation triggers when a new to-do is created in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do list
todolistId True string

Unique identifier of the to-do list.

Returns

A To-do from a To-do List

To-do
ToDo

When a to-do is updated

This operation triggers when an existing to-do is updated in Basecamp.

Parameters

Name Key Required Type Description
Account Id
account_id True integer

Unique identifier of the account.

Basecamp
basecampId True string

Unique identifier of the basecamp.

To-do list
todolistId True string

Unique identifier of the to-do list.

Returns

A To-do from a To-do List

To-do
ToDo

Definitions

AccountList

A list of Accounts

Name Path Type Description
Accounts
accounts array of Account

All accounts you're a part of

Account

A Basecamp account

Name Path Type Description
Id
id integer

Unique identifier of the the Account

Name
name string

The name of the the Account

URL
href string

The URL of the Account

BasecampList

A list of Basecamps

Name Path Type Description
Items
Basecamp

A Basecamp

Basecamp

A Basecamp

Name Path Type Description
Id
id integer

Unique identifier of the the Basecamp

Status
status string

The status of the Basecamp

Name
name string

The name of the the Basecamp

Web URL
app_url string

A link to the basecamp

Bookmarked
bookmarked boolean

Whether or not this basecamp is bookmarked

ToDoList

A To-do list

Name Path Type Description
Id
id integer

Unique identifier of the the to-do list

Name
name string

The name of the the to-do list

Description
description string

A description of the to-do list, formatted as HTML

Completed
completed boolean

Whether or not all items in this to-do list are completed

ToDo

A To-do from a To-do List

Name Path Type Description
Id
id integer

Unique identifier of the the to-do

Content
content string

What the to-do is for

Description
description string

A description of the to-do, formatted as HTML

Due on
due_on date-time

A due date when the to-do should be completed

Start on
start_on date-time

A date when the to-do should be started

Message

A message posted to a basecamp

Name Path Type Description
Subject
subject string

The subject of the message

Content
content string

The content of the message, formatted as HTML

URL
url string

A link to the message

Id
id integer

The unique Id of the message

Created date
created_at date-time

The date the message was posted

Updated date
updated_at date-time

The date the message was updated

Document

A document object

Name Path Type Description
Title
title string

The title of the document

Content
content string

The content of the document, formatted as HTML

URL
app_url string

A link to the document

Id
id integer

The unique Id of the document

Created date
created_at date-time

The date the document was created

Updated date
updated_at date-time

The date the document was updated

Vault Id
vault_id integer
Vault Title
vault_title string
Vault Url
vault_url string

Upload

A file upload object

Name Path Type Description
File name
filename string

The file name of the upload

Description
description string

The description of the uploaded file

URL
app_url string

A link to the file

Id
id integer

The unique Id of the file

Created date
created_at date-time

The date the file was uploaded

Updated date
updated_at date-time

The date the file was updated

Content type
content_type string

The content type of the file

Size
byte_size integer

The size in bytes of the uploaded file

Entry

An entry to schedule

Name Path Type Description
Summary
summary string

A summarized description of the schedule entry

Start time
starts_at date-time

Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:00.000Z)

End time
ends_at date-time

Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:00.000Z)

URL
app_url string

A link to the document

Id
id integer

The unique Id of the document

Created date
created_at date-time

The date the entry was created

Updated date
updated_at date-time

The date the entry was updated