Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node operation creates a new document ("doc") within a specified workspace on the Monday.com platform. It allows users to define the document's name, privacy setting (private or public), and optionally place it inside a specific folder. Additionally, users can add multiple content blocks to the document, such as text, titles, quotes, lists, code snippets, images, videos, and layouts, enabling rich and structured document creation.

Practical scenarios include:

  • Automating the creation of project documentation in a shared workspace.
  • Generating meeting notes with predefined sections and formatting.
  • Creating knowledge base articles with multimedia content organized in blocks.

Properties

Name Meaning
Workspace The workspace where the new document will be created.
Doc Name The name/title for the new document.
Doc Kind Privacy setting for the document; options are Private or Public.
Place in Folder Boolean flag indicating whether to place the document inside a specific folder.
Folder ID The ID of the folder where the document will be created (optional, only if "Place in Folder" is true).
Add Blocks Boolean flag indicating whether to add content blocks to the document (requires API version 2025-01+).
Blocks Collection of content blocks to add to the document. Each block has:
- Block Type: Type of content block (e.g., Normal Text, Large Title, Quote, Bulleted List, Code, Image, Video, Layout, Divider).
- Content: Text content of the block (not applicable for Divider and Layout types).
- Delta Format: Rich text content in Delta JSON format (advanced usage, optional).

Output

The output JSON contains the newly created document's details as returned by the Monday.com API. This includes at least the document ID and metadata about the document such as its name, kind, workspace association, and potentially the added content blocks.

If content blocks were added, the output confirms their successful addition to the document.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for Monday.com.
  • The API version used defaults to "2023-10" but supports features requiring "2025-01" or later when adding content blocks.
  • The node depends on Monday.com's API endpoints for creating documents and adding blocks.
  • The "Workspace" and optionally "Folder" must exist and be accessible via the provided credentials.

Troubleshooting

  • Error: Invalid workspace or folder ID
    Ensure that the workspace ID and folder ID (if used) are correct and accessible with the provided API token.

  • Error: API version not supported for adding blocks
    Adding content blocks requires API version 2025-01 or newer. Verify the API version configured in credentials.

  • Error: Malformed JSON in Delta Format
    When using the advanced Delta format for block content, ensure the JSON is valid. Invalid JSON will cause parsing errors.

  • Permission Denied or Unauthorized
    Check that the API token has sufficient permissions to create documents and add content blocks in the target workspace.

  • Empty or missing required parameters
    Required fields like Workspace, Doc Name, and Doc Kind must be provided. Missing these will cause the operation to fail.

Links and References

Discussion