Businessmap icon

Businessmap

Use Businessmap API v2

Actions48

Main Card → Create

AI-generated

Overview

This node operation creates a new card in the Businessmap platform within a specified board, workflow, lane, and column. It allows users to define various card attributes such as title, description, priority, owner, deadline, size, color, and custom fields. Additional options include tagging, stickers, card types, and templates. This operation is useful for automating task or project management workflows by programmatically adding cards to Businessmap boards.

Use Case Examples

  1. Creating a new task card in a project management board with a specific title, description, priority, and deadline.
  2. Automatically adding a card to a workflow lane when a new issue is reported, including assigning an owner and setting custom fields.
  3. Generating cards with predefined tags, stickers, and templates for standardized task tracking.

Properties

Name Meaning
Board Name or ID Select the board where the card will be created, either by picking from a list or entering the board ID.
Workflow Name or ID Select the workflow within the board where the card will be created, either from a list or by entering the workflow ID.
Lane Name or ID Select the lane within the workflow where the card will be placed, either from a list or by entering the lane ID.
Column Name or ID Select the column within the lane where the card will be placed, either from a list or by entering the column ID.
Custom Card ID Optional custom identifier for the card.
Title Title of the card.
Description Description of the card, can be text or HTML.
Priority Priority level of the card, selectable from Critical, High, Average, or Low.
Owner Name or ID User assigned as the owner of the card, selectable from a list or by entering the user ID.
Deadline Deadline date for the card.
Card Size Size attribute of the card.
Tag, Sticker, Card Type and Template Fields Additional fields to add tags, stickers, card types, or templates to the card.
Color Color to set for the card.
Custom Fields to Set Custom fields on the board to set values for the card.
Output Select the format of the output data: Simplified, Raw, or Selected Fields.
Select Output Fields Specify which fields to include in the output when 'Selected Fields' output is chosen.

Output

JSON

  • card_id - Unique identifier of the created card.
  • board_id - ID of the board where the card was created.
  • workflow_id - ID of the workflow where the card was created.
  • lane_id - ID of the lane where the card was created.
  • column_id - ID of the column where the card was created.
  • title - Title of the created card.
  • description - Description of the created card.
  • priority - Priority level assigned to the card.
  • owner_id - User ID of the card owner.
  • deadline - Deadline date set for the card.
  • size - Size attribute of the card.
  • color - Color assigned to the card.
  • custom_fields - Custom fields and their values set on the card.
  • tags - Tags associated with the card.
  • stickers - Stickers associated with the card.
  • type_id - Card type identifier.
  • template_id - Template identifier applied to the card.

Dependencies

  • Businessmap API with authentication via subdomain and API key

Troubleshooting

  • Ensure all required IDs (board, workflow, lane, column) are numeric and valid to avoid validation errors.
  • If the card creation fails, verify that the API credentials and subdomain are correctly configured.
  • Check that the selected board supports the custom fields, tags, stickers, and templates being applied.
  • If output fields are selected, ensure they exist in the Businessmap card schema to avoid empty or missing data in the output.

Links

Discussion