Businessmap icon

Businessmap

Use Businessmap API v2

Actions48

Card → Set Custom Fields

AI-generated

Overview

This node operation allows users to set custom fields on a specific card within a board in Businessmap. It is useful for updating card details dynamically based on custom field configurations defined on the board. For example, users can automate the process of filling in custom attributes like priority, status, or any other metadata associated with a card.

Use Case Examples

  1. Automatically update a card's custom fields when a related event occurs, such as changing the priority or status based on external triggers.
  2. Batch update multiple cards' custom fields to reflect new project requirements or changes in workflow.

Properties

Name Meaning
Card ID The unique identifier of the card to update. Ensures the card belongs to the selected board.
Board Name or ID The board where the card resides. Can be selected from a list or entered as a numeric ID.
Custom Fields to Set The custom fields on the board to update on the card, with their new values. Loaded dynamically based on the selected board.
Output Determines the format of the output data: Simplified, Raw, or Selected Fields.
Select Output Fields Specifies which fields to include in the output when 'Selected Fields' output mode is chosen. Allows fine-grained control over the returned card data.

Output

JSON

  • card_id - Unique identifier of the updated card.
  • board_id - Identifier of the board containing the card.
  • custom_fields - The updated custom fields on the card with their new values.
  • title - Title of the card.
  • description - Description of the card.
  • priority - Priority level of the card.
  • status - Status or state of the card after update.

Dependencies

  • Businessmap API authentication

Troubleshooting

  • Ensure the Card ID and Board ID are correct and the card belongs to the specified board to avoid errors.
  • Verify that the custom fields being set exist on the selected board and are correctly mapped.
  • If the output is empty or incomplete, check the selected output mode and fields to ensure they match the expected data.
  • Common error messages may include invalid card or board IDs, permission errors, or API connectivity issues. Verify credentials and network access.

Discussion