Monday.com
Visão geral
Seção intitulada “Visão geral”O monday.com é uma plataforma de gestão de trabalho personalizável para planejamento de projetos, colaboração e automação, com suporte a metodologias ágeis, vendas, marketing e muito mais. Com a integração no SquadOS, seus agentes podem criar e gerenciar quadros, itens e grupos, movimentar tarefas entre fluxos, postar atualizações e notificar membros de equipe — tudo de forma programática.
- Site oficial: https://monday.com/
- Documentação na Composio: docs.composio.dev/toolkits/monday
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.
Você vai precisar autorizar o acesso à sua conta Monday.com via OAuth. Nenhuma chave de API manual é necessária — o fluxo de autorização é gerenciado pela Composio.
Como obter a credencial
Seção intitulada “Como obter a credencial”- Um administrador do workspace deve acessar a seguinte URL para instalar o app OAuth2 da Composio uma única vez:
https://auth.monday.com/oauth2/authorize?client_id=96b038435fc029e045f9ba800e66fefa&response_type=install - Após a instalação pelo admin, qualquer usuário do workspace pode autorizar sua conta Monday.com pelo fluxo OAuth padrão da Composio.
- Para configurar credenciais OAuth personalizadas (app próprio), consulte o guia em composio.dev/auth/monday.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Monday.com. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Monday.com via OAuth.
- 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.)
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Por que o OAuth2 do Monday.com não funciona para meus usuários?
Seção intitulada “Por que o OAuth2 do Monday.com não funciona para meus usuários?”O Monday.com exige que um administrador do workspace instale o app OAuth2 antes que qualquer usuário possa autorizar sua conta. Se o app não estiver instalado, os usuários verão um erro de autorização ao tentar conectar.
Preciso instalar o app para cada usuário?
Seção intitulada “Preciso instalar o app para cada usuário?”Não. O admin só precisa instalar o app uma vez por workspace. Após isso, qualquer usuário do workspace pode conectar sua conta pelo fluxo OAuth2 da Composio.
Como configuro escopos personalizados para o Monday.com?
Seção intitulada “Como configuro escopos personalizados para o Monday.com?”O Monday.com não aceita escopos no config de autenticação como o Google. Os escopos são configurados diretamente no app OAuth. Se estiver usando o app padrão, os escopos necessários já estão configurados. Para apps próprios, adicione os escopos necessários como boards:read, boards:write, updates:write, entre outros.
Ações disponíveis
Seção intitulada “Ações disponíveis”Obter quadros
Seção intitulada “Obter quadros”MONDAY_BOARDS
Ferramenta para recuperar dados de quadros via API do Monday.com. Retorna metadados principais (id, nome, estado, tipo, tipo de hierarquia, workspace) sobre um ou mais quadros com opções de filtragem por estado, tipo de quadro, tipo de hierarquia e workspace.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Não | Lista de IDs de quadros específicos a recuperar. |
page | integer | Não | Número da página para paginação; começa em 1. |
limit | integer | Não | Número máximo de quadros a retornar. Padrão: 25. |
state | string | Não | Filtrar quadros por estado. Valores válidos: active, archived, deleted, all. Padrão: active. |
order_by | string | Não | Ordenar quadros por created_at ou used_at em ordem decrescente. |
board_kind | string | Não | Filtrar quadros por tipo: private, public ou share. |
workspace_ids | array | Não | Lista de IDs de workspace para filtrar quadros. |
hierarchy_type | array | Não | Filtrar por tipo de hierarquia: classic, multi_level ou ambos. |
| 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 quadro
Seção intitulada “Criar quadro”MONDAY_CREATE_BOARD
Cria um quadro no Monday.com. O template_id, se usado, deve ser acessível, e o folder_id deve estar no workspace_id se ambos forem fornecidos.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_name | string | Sim | Nome para o novo quadro. |
board_kind | string | Sim | Tipo do quadro: public, private ou share. |
workspace_id | integer | Não | ID numérico do workspace para o quadro. Se omitido, o quadro é criado no workspace padrão. |
folder_id | integer | Não | ID da pasta para o quadro dentro do workspace. |
description | string | Não | Descrição para o novo quadro. |
template_id | integer | Não | ID de um template acessível a usar para o novo quadro. |
board_owner_ids | array | Não | IDs de usuários a serem atribuídos como proprietários do quadro. |
board_subscriber_ids | array | Não | IDs de usuários a serem inscritos no quadro. |
board_subscriber_teams_ids | array | Não | IDs de equipes a serem inscritas no quadro. |
| 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. |
Arquivar quadro
Seção intitulada “Arquivar quadro”MONDAY_ARCHIVE_BOARD
Arquiva um quadro existente e não-arquivado no Monday.com; quadros arquivados podem ser restaurados posteriormente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Sim | Identificador do quadro a ser arquivado; deve existir e não estar arquivado. |
| 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. |
Excluir quadro
Seção intitulada “Excluir quadro”MONDAY_DELETE_BOARD
Exclui permanentemente um quadro da sua conta no Monday.com. Esta ação não pode ser desfeita.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Sim | O identificador único do quadro a ser excluído. |
| 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. |
Duplicar quadro
Seção intitulada “Duplicar quadro”MONDAY_DUPLICATE_BOARD
Duplica um quadro do Monday.com com sua estrutura e, opcionalmente, itens e atualizações. A duplicação é assíncrona e pode demorar para quadros grandes.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Sim | O identificador único do quadro a duplicar. |
duplicate_type | string | Sim | O que incluir na duplicação: duplicate_board_with_structure (só estrutura), duplicate_board_with_pulses (estrutura e itens) ou duplicate_board_with_pulses_and_updates (estrutura, itens e atualizações). |
board_name | string | Não | Nome para o novo quadro. Se omitido, um nome será gerado automaticamente. |
workspace_id | integer | Não | ID do workspace de destino. |
folder_id | integer | Não | ID da pasta de destino dentro do workspace. |
keep_subscribers | boolean | Não | Se deve copiar os inscritos do quadro original. Padrão: false. |
| 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 colunas do quadro
Seção intitulada “Obter colunas do quadro”MONDAY_COLUMNS
Recupera metadados de colunas de quadros via API GraphQL. Retorna array de informações de coluna incluindo tipo, título, configurações e capacidades.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_ids | array | Sim | Array de IDs de quadros para recuperar colunas. Deve conter ao menos um ID. |
column_ids | array | Não | Array opcional de IDs de colunas específicas para filtrar. |
column_types | array | Não | Array opcional de tipos de coluna para filtrar. Tipos disponíveis: auto_number, button, checkbox, date, dropdown, email, file, numbers, people, phone, status, text, timeline, entre outros. |
| 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 grupo
Seção intitulada “Criar grupo”MONDAY_CREATE_GROUP
Cria um novo grupo com o nome fornecido em um quadro existente do Monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | string | Sim | O identificador único do quadro onde o grupo será criado. |
group_name | string | Sim | O nome desejado para o novo grupo. |
| 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 grupos
Seção intitulada “Listar grupos”MONDAY_LIST_GROUPS
Recupera todos os grupos de um quadro especificado. A resposta é aninhada em data → boards[0] → groups.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Sim | O identificador único do quadro do qual recuperar os grupos. |
group_ids | array | Não | Lista opcional de IDs de grupos específicos para filtrar os resultados. IDs inválidos retornam array vazio silenciosamente. |
| 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. |
Excluir grupo
Seção intitulada “Excluir grupo”MONDAY_DELETE_GROUP
Exclui permanentemente um grupo existente (e seus itens) de um quadro no Monday.com.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Sim | Identificador único do quadro que contém o grupo. |
group_id | string | Sim | Identificador único do grupo a excluir. |
| 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 item
Seção intitulada “Criar item”MONDAY_CREATE_ITEM
Cria um novo item em um quadro do Monday.com, opcionalmente atribuindo-o a um grupo e definindo valores de coluna.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | string | Sim | O identificador único do quadro. Quadros de subitens não são suportados; use a mutation create_subitem para isso. |
item_name | string | Sim | Nome do novo item. Comprimento máximo: 256 caracteres. |
group_id | string | Não | ID do grupo onde o item será criado. |
column_values | string | Não | Valores de coluna para o novo item como string JSON ou objeto. As chaves devem ser IDs de coluna válidos. Exemplo para data: {"date": {"date": "YYYY-MM-DD"}}. Para status: {"status": {"index": 0}}. |
| 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 itens por página
Seção intitulada “Obter itens por página”MONDAY_ITEMS_PAGE
Recupera itens de um quadro (ou grupo) do Monday.com com filtragem no servidor, valores de coluna completos e paginação baseada em cursor. Use para acesso paginado a itens com dados de coluna detalhados.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | integer | Não | O identificador único do quadro. Obrigatório para a busca inicial (quando cursor não é fornecido). |
limit | integer | Não | Número de itens a retornar por página. Padrão: 25, máximo: 500. |
cursor | string | Não | Cursor de paginação opaco da resposta anterior. Quando fornecido, recupera a próxima página. Cursors são cacheados por 60 minutos. |
group_id | string | Não | ID de grupo opcional para filtrar itens dentro de um grupo específico. |
query_params | object | Não | Parâmetros de consulta para filtrar e ordenar itens. |
include_column_values | boolean | Não | Se deve incluir column_values na resposta. |
| 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 itens por IDs
Seção intitulada “Obter itens por IDs”MONDAY_GET_ITEMS
Recupera itens específicos pelos seus IDs no Monday.com, retornando metadados incluindo nome, timestamps, estado, quadro e informações do grupo.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Sim | Array de IDs de itens a recuperar. Máximo de 100 IDs por vez. |
page | integer | Não | Número da página para paginação, começando em 1. |
limit | integer | Não | Número de itens a retornar. Padrão: 25, máximo: 100. |
newest_first | boolean | Não | Quando verdadeiro, ordena os resultados pelos itens criados mais recentemente primeiro. |
exclude_nonactive | boolean | Não | Quando verdadeiro, filtra itens inativos, excluídos ou órfãos. |
| 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 itens por valores de coluna
Seção intitulada “Listar itens por valores de coluna”MONDAY_LIST_ITEMS_BY_COLUMN_VALUES
Busca itens em um quadro do Monday.com com base em valores de coluna. Use quando precisar encontrar itens que correspondam a critérios específicos de coluna (ex: status=“Concluído”, nome contém “Tarefa 1”).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
board_id | string | Sim | O identificador único do quadro. |
columns | array | Não | Array de filtros de coluna para buscar. Obrigatório para a requisição inicial (quando cursor não é fornecido). Usa lógica AND entre filtros. |
limit | integer | Não | Número de itens a retornar por página. Padrão: 25, máximo: 500. |
cursor | string | Não | Cursor de paginação opaco da resposta anterior. Quando fornecido, o parâmetro columns é ignorado. |
| 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. |
Arquivar item
Seção intitulada “Arquivar item”MONDAY_ARCHIVE_ITEM
Arquiva um item existente do Monday.com, movendo-o das visualizações ativas para o arquivo onde pode ser potencialmente restaurado.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | integer | Sim | Identificador único do item do Monday.com a arquivar. |
| 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. |
Excluir item
Seção intitulada “Excluir item”MONDAY_DELETE_ITEM
Exclui permanentemente um item existente do Monday.com; esta ação é irreversível via API.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | string | Sim | O identificador único do item do Monday.com a ser excluído. |
| 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. |
Duplicar item
Seção intitulada “Duplicar item”MONDAY_DUPLICATE_ITEM
Duplica um item em um quadro do Monday.com, opcionalmente incluindo suas atualizações.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | integer | Sim | O identificador único do item a ser duplicado. |
board_id | integer | Sim | O identificador único do quadro que contém o item. |
with_updates | boolean | Não | Se verdadeiro, as atualizações do item (comentários, respostas) são duplicadas junto com o item. |
| 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. |
Mover item para grupo
Seção intitulada “Mover item para grupo”MONDAY_MOVE_ITEM_TO_GROUP
Move um item para um grupo diferente no mesmo quadro do Monday.com; o item e o grupo devem existir.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | integer | Sim | O identificador único do item a ser movido. |
group_id | string | Sim | O identificador único do grupo de destino para onde o item será movido. |
| 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 item
Seção intitulada “Atualizar item”MONDAY_UPDATE_ITEM
Atualiza o valor de uma coluna de um item existente no Monday.com. Use para definir tipos de coluna complexos como Timeline ou Pessoas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | string | Sim | ID do item a atualizar. |
board_id | string | Sim | ID do quadro que contém o item. |
column_id | string | Sim | O identificador único da coluna a alterar. |
value | string | Sim | Novo valor de coluna como objeto JSON-serializável ou string. Para colunas de texto/número/nome, envie uma string simples; para colunas complexas como status/timeline/pessoas, envie um objeto JSON (ex: {"index": 1}). |
create_labels_if_missing | boolean | Não | Se verdadeiro, cria rótulos ausentes para colunas Status/Dropdown. Requer permissão para alterar a estrutura do quadro. |
| 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. |
Alterar valor simples de coluna
Seção intitulada “Alterar valor simples de coluna”MONDAY_CHANGE_SIMPLE_COLUMN_VALUE
Altera o valor de uma coluna específica de um item do Monday.com usando uma string simples, adequado para colunas de Texto, Status ou Dropdown.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | integer | Sim | O identificador único do item cujo valor de coluna será atualizado. |
board_id | integer | Sim | O identificador único do quadro onde o item e a coluna estão. |
column_id | string | Sim | Identificador da coluna a alterar; tipicamente uma coluna de Texto, Status ou Dropdown. |
value | string | Sim | Novo valor em string. Para colunas Status: use o nome do rótulo (ex: Done) ou número de índice como string (ex: 1). Para Dropdown: use o nome do rótulo. Para Texto: use texto simples. |
create_labels_if_missing | boolean | Não | Para colunas Status/Dropdown: quando verdadeiro (padrão), o rótulo será correspondido ou criado se não existir. |
| 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 atualização
Seção intitulada “Criar atualização”MONDAY_CREATE_UPDATE
Cria uma nova atualização para um item ou responde a uma atualização existente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
body | string | Sim | O conteúdo de texto da atualização. |
item_id | integer | Não | ID do item em que a atualização será postada. |
parent_id | integer | Não | ID da atualização pai para responder. |
use_app_info | boolean | Não | Se verdadeiro, atribui a atualização ao app em vez do usuário atual (versão de API 2025-10+). |
mentions_list | array | Não | Lista de entidades a mencionar na atualização. |
original_creation_date | string | Não | Data de criação original no formato DD-MM-YYYY (versão de API 2025-10+). |
| 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. |
Editar atualização
Seção intitulada “Editar atualização”MONDAY_EDIT_UPDATE
Modifica o conteúdo de texto de uma atualização existente em um item. Use quando precisar corrigir ou alterar uma atualização postada anteriormente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | integer | Sim | O identificador único da atualização. |
body | string | Sim | O novo conteúdo de texto da atualização. |
| 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 atualizações de item
Seção intitulada “Obter atualizações de item”MONDAY_GET_UPDATES
Recupera atualizações de um item específico. Use quando precisar buscar o histórico de conversas vinculado a um item.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
item_id | string | Sim | O identificador único do item para buscar atualizações. |
page | integer | Não | Número da página para paginação (começa em 1). |
limit | integer | Não | Número de atualizações a retornar por página (máx: 100, padrão: 25). |
| 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 notificação
Seção intitulada “Criar notificação”MONDAY_CREATE_NOTIFICATION
Envia uma notificação para um usuário. Use para alertar um usuário sobre um quadro, item ou atualização.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
text | string | Sim | O texto da notificação a exibir. |
user_id | integer | Sim | O identificador único do usuário destinatário. |
target_id | integer | Sim | O identificador único do alvo. Se target_type for Post, use um ID de atualização ou resposta; se Project, use um ID de item ou quadro. |
target_type | string | Sim | O tipo de alvo da notificação: Post para atualizações/respostas ou Project para itens/quadros. |
| 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 usuários
Seção intitulada “Listar usuários”MONDAY_LIST_USERS
Recupera uma lista de usuários do Monday.com. Para paginar, comece em page=1 e incremente a cada requisição, parando quando a lista retornada estiver vazia.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Número da página para os resultados; começa em 1. |
limit | integer | Não | Número máximo de usuários a retornar por página. |
| 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 usuário atual
Seção intitulada “Obter usuário atual”MONDAY_GET_ME
Busca o perfil e as permissões do usuário autenticado atual. Use quando precisar recuperar metadados do usuário antes de realizar outras operações.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
api_version | string | Não | Cabeçalho opcional de versão da API Monday (ex: 2025-04). Substitui o padrão se fornecido. |
| 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 workspaces
Seção intitulada “Obter workspaces”MONDAY_GET_WORKSPACES
Recupera workspaces com filtragem opcional, paginação ou ordenação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Não | Lista de IDs de workspaces específicos a retornar. |
kind | string | Não | Filtrar por tipo de workspace: open ou closed. |
page | integer | Não | Número da página para paginação; começa em 1. |
limit | integer | Não | Número máximo de workspaces a retornar. Padrão: 25. |
state | string | Não | Filtrar por estado do workspace: active, all, archived ou deleted. |
order_by | string | Não | Campo para ordenar. Atualmente apenas created_at é suportado. |
| 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. |
Recuperar docs do Monday
Seção intitulada “Recuperar docs do Monday”MONDAY_DOCS
Recupera dados de documentos do Monday.com via API, com filtragem por IDs, IDs de objeto, IDs de workspace e suporte a paginação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ids | array | Não | Lista de IDs de documentos a recuperar. |
page | integer | Não | Número da página para paginação. Começa em 1. |
limit | integer | Não | Número máximo de documentos a recuperar por página (1–100). Padrão: 25. |
order_by | string | Não | Campo para ordenar os resultados: created_at ou used_at. Mais recente primeiro por padrão. |
object_ids | array | Não | Lista de IDs de objeto (IDs de quadro ou item) associados aos documentos. |
workspace_ids | array | Não | Lista de IDs de workspace para filtrar documentos. |
| 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 doc
Seção intitulada “Criar doc”MONDAY_CREATE_DOC
Cria um novo doc no Monday.com em um workspace ou em uma coluna de doc em um item.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
workspace_id | integer | Não | ID do workspace onde o doc será criado. Obrigatório com name e kind para localização em workspace. |
name | string | Não | Título do novo doc. Obrigatório com workspace_id e kind para localização em workspace. |
kind | string | Não | Nível de acesso do novo doc no workspace: private, public ou share. |
item_id | integer | Não | ID do item que contém a coluna de doc. Obrigatório com column_id para localização em quadro. |
column_id | string | Não | ID da coluna de doc monday no item (ex: monday_doc). Obrigatório com item_id para localização em quadro. |
| 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 informações da conta
Seção intitulada “Obter informações da conta”MONDAY_GET_ACCOUNT_INFO
Recupera metadados e configurações da conta Monday.com autenticada, incluindo nome, slug, nível, contagem de membros ativos, preferências de calendário e detalhes do plano de cobrança. Requer o escopo OAuth account:read.
| 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 ativo
Seção intitulada “Fazer upload de ativo”MONDAY_UPLOAD_ASSET
Faz upload de um arquivo para uma atualização ou coluna de arquivo. Anexos de arquivo são permanentes e irreversíveis; confirme com o usuário antes de fazer upload.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
file | object | Sim | Arquivo a fazer upload. |
target | string | Sim | Onde fazer upload do arquivo. Use update para anexar a uma atualização/comentário existente, ou column para fazer upload em uma coluna de arquivo em um item. |
item_id | integer | Não | ID numérico do item que contém a coluna de arquivo. Obrigatório quando target é column. |
column_id | string | Não | ID da coluna de arquivo para upload. Obrigatório quando target é column. |
update_id | integer | Não | ID numérico da atualização (comentário) ao qual anexar o arquivo. Obrigatório quando target é update. |
| 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. |