Basecamp

Manage Basecamp projects, to-do lists, and tasks directly from Lodol with create, list, and comment actions.

Actions

Action	What it does
Add comment to message	Adds a comment to a Basecamp message.
Add comment to to-do	Adds a comment to a Basecamp to-do item.
Add person to project	Grants an existing Basecamp person access to a project.
Complete to-do	Marks a Basecamp to-do item as completed.
Create document	Creates a new document in a Basecamp project's Docs & Files.
Create message	Posts a new message to a Basecamp project's message board.
Create project	Creates a new Basecamp project.
Create to-do	Creates a new to-do item within a Basecamp to-do list.
Create to-do list	Creates a new to-do list inside a Basecamp project.
Get document	Retrieves a single Basecamp document by its ID.
Get person	Retrieves a single Basecamp person by their ID.
Get project	Retrieves a single Basecamp project by its ID.
Get to-do	Retrieves a single Basecamp to-do item by its ID.
Get to-do list	Retrieves a single Basecamp to-do list by its ID.
List documents	Lists the documents in a Basecamp project's Docs & Files.
List projects	Lists Basecamp projects available to the connected account.
List to-do lists	Lists the to-do lists inside a Basecamp project.
List to-dos	Lists the to-dos within a Basecamp to-do list.
Update to-do	Updates a Basecamp to-do item's content, notes, or due date.

Add comment to message

Adds a comment to a Basecamp message.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
Message IDmessage_idtextRequired: The message's ID. Use the ID returned by 'Create message'.
Comment textcontenttextRequired: The comment to add to the message.

Outputs

contenttext: Comment text.
idnumber: Comment ID.

Example output

{
  "content": "Looks great!",
  "id": 888
}

Add comment to to-do

Adds a comment to a Basecamp to-do item.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do IDtodo_idtextRequired: The to-do's ID. Use 'List to-dos' to find it.
Comment textcontenttextRequired: The comment to add to the to-do.

Outputs

contenttext: Comment text.
idnumber: Comment ID.

Example output

{
  "content": "Great progress!",
  "id": 999
}

Add person to project

Grants an existing Basecamp person access to a project.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
Person IDperson_idtextRequired: The ID of the person to add. Use 'Get person' or your account's people list to find it.

Outputs

grantedlist: People who were granted access.

Example output

{
  "granted": [
    {
      "id": 5555,
      "name": "Sam Rivera"
    }
  ]
}

Complete to-do

Marks a Basecamp to-do item as completed.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do IDtodo_idtextRequired: The to-do's ID. Use 'List to-dos' to find it.

Outputs

completedtrue/false: Completion status.
idtext: Completed to-do ID.

Example output

{
  "completed": true,
  "id": "456"
}

Create document

Creates a new document in a Basecamp project's Docs & Files.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
Document titletitletextRequired: A title for the new document.
Document contentcontenttextRequired: The document body. Basic HTML formatting (paragraphs, lists, links) is supported.

Outputs

idnumber: Created document ID.
titletext: Document title.

Example output

{
  "id": 321,
  "title": "Project brief"
}

Create message

Posts a new message to a Basecamp project's message board.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
SubjectsubjecttextRequired: The message subject line.
Message bodycontenttextRequired: The message body. Basic HTML formatting is supported.

Outputs

idnumber: Created message ID.
subjecttext: Message subject.

Example output

{
  "id": 777,
  "subject": "Kickoff"
}

Create project

Creates a new Basecamp project.

Inputs

Project namenametextRequired: A name for the new project, for example, Website Redesign.
Descriptiondescriptiontext: An optional description of what the project is for.

Outputs

idnumber: Created project ID.
nametext: Project name.

Example output

{
  "id": 1234567,
  "name": "Website Redesign"
}

Create to-do

Creates a new to-do item within a Basecamp to-do list.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do list IDtodolist_idtextRequired: The to-do list's ID. Use 'List to-do lists' to find it.
To-do textcontenttextRequired: What needs to be done, for example, Send the launch email.
Descriptiondescriptiontext: An optional note with extra details about the to-do.
Due datedue_ondate: An optional due date for the to-do.

Outputs

contenttext: To-do content.
idnumber: Created to-do ID.

Example output

{
  "content": "Buy supplies",
  "id": 789
}

Create to-do list

Creates a new to-do list inside a Basecamp project.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
List namenametextRequired: A name for the new to-do list, for example, Launch checklist.
Descriptiondescriptiontext: An optional note describing what the list is for.

Outputs

idnumber: Created to-do list ID.
titletext: To-do list name.

Example output

{
  "id": 123,
  "title": "Launch checklist"
}

Get document

Retrieves a single Basecamp document by its ID.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
Document IDdocument_idtextRequired: The document's ID. Use 'List documents' to find it.

Outputs

contenttext: Document content (HTML).
idnumber: Document ID.
titletext: Document title.

Example output

{
  "content": "<div>The plan.</div>",
  "id": 321,
  "title": "Project brief"
}

Get person

Retrieves a single Basecamp person by their ID.

Inputs

Person IDperson_idtextRequired: The person's ID.

Outputs

email_addresstext: Person's email address.
idnumber: Person ID.
nametext: Person's name.

Example output

{
  "email_address": "sam@example.com",
  "id": 5555,
  "name": "Sam Rivera"
}

Get project

Retrieves a single Basecamp project by its ID.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.

Outputs

descriptiontext: Project description.
idnumber: Project ID.
nametext: Project name.

Example output

{
  "description": "Marketing site refresh.",
  "id": 1234567,
  "name": "Website Redesign"
}

Get to-do

Retrieves a single Basecamp to-do item by its ID.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do IDtodo_idtextRequired: The to-do's ID. Use 'List to-dos' to find it.

Outputs

completedtrue/false: Completion status.
contenttext: To-do content.
idnumber: To-do ID.

Example output

{
  "completed": false,
  "content": "Buy supplies",
  "id": 456
}

Get to-do list

Retrieves a single Basecamp to-do list by its ID.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do list IDtodolist_idtextRequired: The to-do list's ID. Use 'List to-do lists' to find it.

Outputs

idnumber: To-do list ID.
titletext: To-do list name.

Example output

{
  "id": 123,
  "title": "Launch checklist"
}

List documents

Lists the documents in a Basecamp project's Docs & Files.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.

Outputs

documentslist: List of documents.

Example output

{
  "documents": [
    {
      "id": 321,
      "title": "Project brief"
    }
  ]
}

List projects

Lists Basecamp projects available to the connected account.

Inputs

None.

Outputs

projectslist: List of projects.

Example output

{
  "projects": [
    {
      "id": 1234567,
      "name": "Test Project"
    }
  ]
}

List to-do lists

Lists the to-do lists inside a Basecamp project.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.

Outputs

todolistslist: List of to-do lists.

Example output

{
  "todolists": [
    {
      "id": 123,
      "title": "Launch checklist"
    }
  ]
}

List to-dos

Lists the to-dos within a Basecamp to-do list.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do list IDtodolist_idtextRequired: The to-do list's ID. Use 'List to-do lists' to find it.

Outputs

todoslist: List of to-dos.

Example output

{
  "todos": [
    {
      "completed": false,
      "content": "Buy supplies",
      "id": 456
    }
  ]
}

Update to-do

Updates a Basecamp to-do item's content, notes, or due date.

Inputs

Project IDproject_idtextRequired: The project's ID. Use 'List projects' to find it.
To-do IDtodo_idtextRequired: The to-do's ID. Use 'List to-dos' to find it.
To-do textcontenttextRequired: The updated to-do text. Basecamp requires the content on every update.
Descriptiondescriptiontext: Optional updated notes for the to-do.
Due datedue_ondate: An optional due date for the to-do.

Outputs

contenttext: To-do content.
idnumber: To-do ID.

Example output

{
  "content": "Buy supplies and snacks",
  "id": 456
}

ActionsCopy Anchor Link

Add comment to messageCopy Anchor Link

Inputs

Outputs

Add comment to to-doCopy Anchor Link

Inputs

Outputs

Add person to projectCopy Anchor Link

Inputs

Outputs

Complete to-doCopy Anchor Link

Inputs

Outputs

Create documentCopy Anchor Link

Inputs

Outputs

Create messageCopy Anchor Link

Inputs

Outputs

Create projectCopy Anchor Link

Inputs

Outputs

Create to-doCopy Anchor Link

Inputs

Outputs

Create to-do listCopy Anchor Link

Inputs

Outputs

Get documentCopy Anchor Link

Inputs

Outputs

Get personCopy Anchor Link

Inputs

Outputs

Get projectCopy Anchor Link

Inputs

Outputs

Get to-doCopy Anchor Link

Inputs

Outputs

Get to-do listCopy Anchor Link

Inputs

Outputs

List documentsCopy Anchor Link

Inputs

Outputs

List projectsCopy Anchor Link

Inputs

Outputs

List to-do listsCopy Anchor Link

Inputs

Outputs

List to-dosCopy Anchor Link

Inputs

Outputs

Update to-doCopy Anchor Link

Inputs

Outputs

On this page

Actions

Add comment to message

Add comment to to-do

Add person to project

Complete to-do

Create document

Create message

Create project

Create to-do

Create to-do list

Get document

Get person

Get project

Get to-do

Get to-do list

List documents

List projects

List to-do lists

List to-dos

Update to-do