Basecamp

Visão geral

Basecamp é uma ferramenta de gerenciamento de projetos e colaboração em equipe criada pela 37signals. Com ela é possível criar projetos, listas de tarefas, documentos, agendas de eventos e salas de bate-papo em um único lugar. Com a integração Basecamp no SquadOS, seus agentes podem criar e atualizar tarefas, publicar mensagens, gerenciar documentos e acompanhar o andamento de projetos de forma totalmente automatizada.

• Site oficial: https://basecamp.com/
• Documentação na Composio: docs.composio.dev/toolkits/basecamp

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar autorizar o acesso à sua conta Basecamp via fluxo OAuth seguro — nenhuma chave de API manual é necessária.

Campo	Obrigatório	Descrição
Conta Basecamp	Sim	Autorize o acesso à sua conta Basecamp pelo fluxo OAuth gerenciado pela Composio.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Basecamp.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Basecamp via OAuth.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Nota

Esta integração expõe 140 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Listar projetos

BASECAMP_GET_PROJECTS

Recupera uma lista paginada de projetos visíveis ao usuário atual, ordenados pelo mais recentemente criado. Use para listar todos os projetos ou filtrar por status.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
status	string	Não	Filtra projetos por status. Aceita archived ou trashed. Omitir retorna projetos ativos.
account_id	integer	Não	ID da conta Basecamp. Use quando tiver acesso a múltiplas contas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter projeto por ID

BASECAMP_GET_PROJECTS_BY_PROJECT_ID

Recupera um único projeto pelo seu ID com todos os detalhes, incluindo ferramentas do dock. Use para obter informações completas de um projeto específico.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
project_id	integer	Sim	Identificador único do projeto a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar novo projeto

BASECAMP_POST_PROJECTS

Cria um novo projeto no Basecamp com nome e descrição opcional. Use para configurar um novo espaço de trabalho em equipe.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Título/nome do projeto. Campo obrigatório.
description	string	Não	Detalhes adicionais sobre o propósito ou escopo do projeto.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar projeto

BASECAMP_PUT_PROJECTS

Atualiza o nome, descrição, política de acesso ou agenda de um projeto existente no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Título do projeto. Campo obrigatório.
project_id	integer	Sim	Identificador único do projeto a atualizar.
description	string	Não	Informações adicionais sobre o projeto.
admissions	string	Não	Política de controle de acesso: invite (somente convidados), employee (todos da conta), team (membros não-clientes).
schedule_attributes	object	Não	Atributos de agenda para definir datas de início e término do projeto.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Conceder ou revogar acesso ao projeto

BASECAMP_PUT_PROJECTS_PEOPLE_USERS

Concede ou revoga acesso de usuários a um projeto no Basecamp. Pelo menos um dos parâmetros grant, revoke ou create deve ser fornecido.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
project_id	integer	Sim	Identificador único do projeto.
grant	array	Não	Lista de IDs de pessoas a quem conceder acesso ao projeto.
revoke	array	Não	Lista de IDs de pessoas a remover do projeto.
create	array	Não	Lista de novas pessoas a criar e adicionar ao projeto.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar tarefa em lista de tarefas

BASECAMP_POST_BUCKETS_TODOLISTS_TODOS

Cria uma tarefa em uma lista de tarefas do Basecamp dentro de um projeto, com descrição, responsáveis e prazo opcionais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	Descrição principal da tarefa. Campo obrigatório.
bucket_id	integer	Sim	ID do projeto/bucket onde a lista de tarefas existe.
todolist_id	integer	Sim	ID da lista de tarefas onde a tarefa será criada.
description	string	Não	Detalhes sobre a tarefa; suporta formatação HTML.
assignee_ids	array	Não	IDs das pessoas responsáveis pela tarefa.
due_on	string	Não	Prazo de conclusão no formato YYYY-MM-DD.
starts_on	string	Não	Data de início no formato YYYY-MM-DD.
notify	boolean	Não	Quando verdadeiro, notifica os responsáveis sobre a atribuição.
completion_subscriber_ids	array	Não	IDs das pessoas a notificar na conclusão da tarefa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar tarefas de uma lista

BASECAMP_GET_BUCKETS_TODOLISTS_TODOS

Recupera todas as tarefas de uma lista de tarefas específica dentro de um projeto.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bucket_id	integer	Sim	ID do projeto/bucket que contém a lista de tarefas.
todolist_id	integer	Sim	ID da lista de tarefas cujas tarefas serão recuperadas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar tarefa

BASECAMP_UPDATE_TODO

Atualiza o conteúdo, responsáveis ou prazo de uma tarefa existente no Basecamp. Passe todos os parâmetros existentes junto com os que estão sendo atualizados para evitar limpar valores.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	Descrição principal da tarefa. Sempre obrigatório e não pode estar em branco.
todo_id	integer	Sim	ID da tarefa a atualizar.
bucket_id	integer	Sim	ID do projeto/bucket que contém a tarefa.
description	string	Não	Conteúdo HTML adicional sobre a tarefa.
assignee_ids	array	Não	Lista de IDs das pessoas responsáveis pela tarefa.
due_on	string	Não	Prazo de conclusão no formato ISO 8601 (YYYY-MM-DD).
starts_on	string	Não	Data de início no formato ISO 8601 (YYYY-MM-DD).
notify	boolean	Não	Quando verdadeiro, envia notificações aos responsáveis sobre a atribuição.
completion_subscriber_ids	array	Não	IDs das pessoas a notificar na conclusão da tarefa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Concluir tarefa

BASECAMP_COMPLETE_TODO

Marca uma tarefa como concluída no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
todo_id	integer	Sim	ID da tarefa a marcar como concluída.
bucket_id	integer	Sim	ID do projeto/bucket que contém a tarefa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Desfazer conclusão de tarefa

BASECAMP_UNCOMPLETE_TODO

Reverte o status de conclusão de uma tarefa já marcada como concluída no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
todo_id	integer	Sim	ID da tarefa a marcar como não concluída.
bucket_id	integer	Sim	ID do projeto/bucket onde a tarefa está.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar lista de tarefas em conjunto de tarefas

BASECAMP_POST_BUCKETS_TODOSETS_TODOLISTS

Cria uma nova lista de tarefas dentro de um conjunto de tarefas de um projeto no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome da lista de tarefas. Campo obrigatório.
bucket_id	integer	Sim	ID do projeto/bucket onde o conjunto de tarefas existe.
todoset_id	integer	Sim	ID do conjunto de tarefas onde a lista será criada.
description	string	Não	Descrição da lista de tarefas; suporta formatação HTML.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Publicar mensagem no mural

BASECAMP_POST_BUCKETS_MESSAGE_BOARDS_MESSAGES

Publica uma mensagem em um mural de mensagens de um projeto no Basecamp, com conteúdo HTML e assinantes opcionais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
subject	string	Sim	Título/assunto da mensagem.
status	string	Sim	Status da mensagem. Use active para publicar imediatamente.
bucket_id	integer	Sim	Identificador do projeto/bucket.
message_board_id	integer	Sim	Identificador do mural de mensagens.
content	string	Não	Corpo da mensagem com suporte a tags HTML.
category_id	integer	Não	Tipo de mensagem; recuperar via endpoint de categorias.
subscriptions	array	Não	IDs de pessoas a notificar e assinar a mensagem. Se omitido, todos os membros do projeto são notificados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter mensagens do mural

BASECAMP_GET_BUCKETS_MESSAGE_BOARDS_MESSAGES

Recupera todas as mensagens de um mural de mensagens específico dentro de um projeto.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bucket_id	integer	Sim	ID do projeto/bucket que contém o mural.
message_board_id	integer	Sim	ID do mural de mensagens.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar comentário a um item

BASECAMP_POST_BUCKETS_RECORDINGS_COMMENTS

Publica um comentário em qualquer item (recording) de um projeto no Basecamp, como lista de tarefas, mensagem ou documento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	Conteúdo do comentário em HTML. Suporta formatação rica com tags HTML permitidas.
bucket_id	integer	Sim	ID do projeto/bucket onde o item existe.
recording_id	integer	Sim	ID do item ao qual o comentário será adicionado.
account_id	integer	Não	ID da conta Basecamp. Use quando o item estiver em conta diferente da padrão.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar entrada na agenda

BASECAMP_POST_BUCKETS_SCHEDULES_ENTRIES

Cria uma entrada de agenda em um projeto no Basecamp com horário de início/término e participantes opcionais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
summary	string	Sim	Título ou assunto da entrada de agenda.
starts_at	string	Sim	Data/hora de início no formato ISO 8601. Exemplo: 2025-12-15T10:00:00Z.
ends_at	string	Sim	Data/hora de término no formato ISO 8601. Exemplo: 2025-12-15T11:00:00Z.
bucket_id	integer	Sim	ID do projeto/bucket onde a agenda existe.
schedule_id	integer	Sim	ID da agenda onde a entrada será criada.
description	string	Não	Informações adicionais sobre a entrada em formato HTML.
participant_ids	array	Não	IDs das pessoas a incluir como participantes.
all_day	boolean	Não	Quando verdadeiro, a entrada abrange o(s) dia(s) inteiro(s) sem horários específicos.
notify	boolean	Não	Quando verdadeiro, os participantes recebem notificações.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar entradas da agenda

BASECAMP_GET_BUCKETS_SCHEDULES_ENTRIES

Recupera todas as entradas de uma agenda de projeto no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bucket_id	integer	Sim	ID do projeto/bucket que contém a agenda.
schedule_id	integer	Sim	ID da agenda cujas entradas serão recuperadas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar documento em vault

BASECAMP_CREATE_DOCUMENT

Cria um novo documento em um vault (pasta de documentos) de um projeto no Basecamp, com título, conteúdo HTML e status de publicação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Sim	Título do documento. Campo obrigatório.
content	string	Sim	Corpo do documento em formato HTML.
vault_id	integer	Sim	ID do vault onde o documento será criado.
bucket_id	integer	Sim	ID do projeto/bucket onde o vault existe.
status	string	Não	Status de publicação. Use active para publicar imediatamente na criação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar documentos do vault

BASECAMP_GET_BUCKETS_VAULTS_DOCUMENTS

Recupera todos os documentos de um vault específico dentro de um projeto no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bucket_id	integer	Sim	ID do projeto/bucket que contém o vault.
vault_id	integer	Sim	ID do vault cujos documentos serão listados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar card em coluna de kanban

BASECAMP_CREATE_CARD

Cria um novo card em uma coluna de um kanban de projeto no Basecamp, com título, prazo e conteúdo opcional.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Sim	Título do card. Deve ser um nome descritivo.
bucket_id	integer	Sim	ID do projeto/bucket onde o kanban está.
column_id	integer	Sim	ID da coluna do kanban onde o card será criado.
content	string	Não	Descrição do card com suporte a HTML.
due_on	string	Não	Prazo do card no formato ISO 8601 (YYYY-MM-DD).
notify	boolean	Não	Se verdadeiro, alerta os responsáveis.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter kanban do projeto

BASECAMP_GET_CARD_TABLE

Recupera o kanban (card table) de um projeto, incluindo colunas e configurações.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bucket_id	integer	Sim	ID do projeto/bucket que contém o kanban.
card_table_id	integer	Sim	ID do kanban a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar membros do projeto

BASECAMP_GET_PROJECTS_PEOPLE

Recupera todas as pessoas ativas atribuídas a um projeto no Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
project_id	integer	Sim	Identificador único do projeto cujos membros serão recuperados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter todas as pessoas

BASECAMP_GET_ALL_PEOPLE

Recupera todas as pessoas ativas da conta Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
account_id	integer	Não	ID da conta Basecamp. Use quando tiver acesso a múltiplas contas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter relatório de horas

BASECAMP_GET_REPORTS_TIMESHEET

Recupera todos os registros de horas da conta Basecamp dentro de um período. Sem parâmetros de data, retorna apenas o último mês.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
start_date	string	Não	Data de início do relatório no formato ISO 8601 (YYYY-MM-DD). Se fornecida, end_date também é obrigatória.
end_date	string	Não	Data de término do relatório no formato ISO 8601 (YYYY-MM-DD). Se fornecida, start_date também é obrigatória.
bucket_id	integer	Não	Filtra por um único projeto pelo ID. Padrão: todos os projetos.
person_id	integer	Não	Filtra por uma única pessoa pelo ID. Padrão: todos os usuários.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar items de gravação em projetos

BASECAMP_GET_PROJECTS_RECORDINGS

Recupera uma lista paginada de registros de um tipo específico em todos os projetos, com filtragem opcional por projeto, status e ordenação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
recording_type	string	Sim	Categoria de item a recuperar. Valores aceitos: Comment, Document, Kanban::Card, Kanban::Step, Message, Question::Answer, Schedule::Entry, Todo, Todolist, Upload, Vault.
bucket	string	Não	IDs de projeto(s) separados por vírgula. Padrão: todos os projetos ativos.
status	string	Não	Filtra por status: active, archived ou trashed. Padrão: active.
sort	string	Não	Ordena por created_at ou updated_at. Padrão: created_at.
direction	string	Não	Direção da ordenação: desc ou asc. Padrão: desc.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar projeto a partir de template

BASECAMP_CREATE_PROJECT_CONSTRUCTION

Cria um novo projeto a partir de um template do Basecamp de forma assíncrona. Monitore o progresso via URL retornada até o status ser completed.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
project	object	Sim	Detalhes do projeto incluindo o name obrigatório e description opcional.
template_id	integer	Sim	ID do template a usar para criar o projeto.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar templates

BASECAMP_GET_TEMPLATES

Recupera todos os templates disponíveis na conta Basecamp.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
account_id	integer	Não	ID da conta Basecamp. Use quando tiver acesso a múltiplas contas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de arquivo

BASECAMP_UPLOAD_FILE_ATTACHMENT

Faz upload de um arquivo como anexo no Basecamp para uso posterior em documentos, mensagens ou uploads de vault.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	Conteúdo binário do arquivo a ser enviado.
content_type	string	Sim	Tipo MIME do arquivo (ex.: image/png, application/pdf).
filename	string	Sim	Nome do arquivo com extensão.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter meu perfil

BASECAMP_GET_MY_PROFILE

Recupera o perfil do usuário autenticado no Basecamp, incluindo nome, e-mail e ID.

Parâmetros de entrada

Nenhum parâmetro necessário.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.