Basecamp 3 (Preview)

Reference

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 - US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://basecamp.com/
Privacy policy	https://basecamp.com/about/policies/privacy

Known Issues and Limitations

Basecamp parameter in all actions and triggers is limited to return top 15 results. If you don't see a basecamp in the dropdown, specify basecamp ID manually as a custom value. However, this workaround will not work in the following triggers and actions: Create a schedule entry, Post a message, When a message is posted, When a schedule entry is created, When a schedule entry is updated.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	30	60 seconds
Frequency of trigger polls	1	15 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

Operation ID:: CompleteToDo

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

Operation ID:: CreateDocument

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

Operation ID:: CreateScheduleEntry

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

Operation ID:: CreateToDo

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

Operation ID:: DeleteDocument

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

Operation ID:: DeleteScheduledEntry

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

Operation ID:: DeleteToDo

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]

Operation ID:: DeleteObject

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

Operation ID:: ListAccounts

List Accounts you're a part of

Returns

A list of Accounts

Accounts: AccountList

List Basecamps

Operation ID:: ListBasecamps

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

Operation ID:: ListToDoLists

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

Operation ID:: ListToDos

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

Operation ID:: PostMessage

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

Operation ID:: UncompleteToDo

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

Operation ID:: UploadFile

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

Operation ID:: OnDocumentCreated

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

Operation ID:: OnDocumentDeleted

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

Operation ID:: OnDocumentUpdated

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

Operation ID:: OnFileUpdated

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

Operation ID:: OnFileUploaded

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

Operation ID:: OnMessagePosted

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

Operation ID:: OnScheduledEntryCreated

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

Operation ID:: OnScheduledEntryDeleted

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

Operation ID:: OnScheduledEntryUpdated

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

Operation ID:: OnToDoCreated

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

Operation ID:: OnToDoUpdated

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

Jaa

Basecamp 3 (Preview)

Known Issues and Limitations

Throttling Limits

Actions

Complete a to-do

Parameters

Create a document

Parameters

Returns

Create a schedule entry

Parameters

Returns

Create a to-do

Parameters

Returns

Delete a document

Parameters

Delete a scheduled entry

Parameters

Delete a to-do

Parameters

Delete an object [DEPRECATED]

Parameters

List Accounts

Returns

List Basecamps

Parameters

Returns

List to-do lists

Parameters

Returns

List to-dos

Parameters

Returns

Post a message

Parameters

Returns

Uncomplete a to-do

Parameters

Upload file

Parameters

Returns

Triggers

When a document is created

Parameters

Returns

When a document is deleted

Parameters

Returns

When a document is updated

Parameters

Returns

When a file is updated

Parameters

Returns

When a file is uploaded

Parameters

Returns

When a message is posted

Parameters

Returns

When a schedule entry is created

Parameters

Returns

When a schedule entry is deleted

Parameters

Returns

When a schedule entry is updated

Parameters

Returns

When a to-do is created

Parameters

Returns

When a to-do is updated

Parameters

Returns

Definitions

AccountList

Account