Resources · n8n integration

Businessmap n8n integrationAutomate Businessmap with n8n.

Which Businessmap moves can a workflow make on its own? The Businessmap n8n integration opens 48 operations across 8 resources, from creating a card to logging time and pulling attachments, plus a trigger that listens to 18 board events. It fits teams running delivery on a Kanban board.

Community node This node is not shipped with n8n: it is a community package (n8n-nodes-businessmap) you install from Settings › Community nodes on a self-hosted instance. npm

Verified Trustpilot reviews · AI, automation & growth agency

Why automate

What does the Businessmap n8n integration cover?

Once it is in place, it behaves like any other node: one credential, 48 operations, 8 resources, and a trigger built on a webhook that covers card lifecycle events, comment events, subtask events and board events, so a change made anywhere on the board reaches n8n without any polling in between, whether that change is a card moving between lanes or a comment added by a teammate.

Take intake first. A form, a mailbox or a support tool drops a request, and mainCard.create puts a card in the right board, workflow, lane and column with a deadline and an owner already set. Add cards.comment to paste the original request into the card, then push a short line to Slack so the lane owner sees it before standup.

Second, reporting. mainCard.getAllCardsPerBoard pulls every card of a board, and Select Output Fields keeps only what a spreadsheet needs, say card_id, title, deadline and current_cycle_time. Feed that into Google Sheets every morning and the weekly cycle time chart builds itself.

Third, the housekeeping nobody enjoys. A card sitting in the same column past its deadline gets cards.block with a block reason and a comment. A card that ships gets cards.archive. Time spent in a meeting tool lands on the card through cards.logtime, and an invoice PDF joins it with attachments.upload.

When an endpoint of the Businessmap API sits outside the 48 operations, the HTTP Request node calls it directly and reuses the same credential through predefined authentication. That covers the gaps without waiting for a new version of the package.

Two limits worth knowing before you build. The trigger attaches to one board, since Board Name or ID is required, so watching four boards means four trigger nodes. And every read operation returns what Output decides, so a workflow that expects custom_fields gets nothing back unless the field is selected. If you would rather receive events from a tool that has no node at all, the generic Webhook node stays the fallback.

Connect

How do you connect Businessmap to n8n?

  1. 01

    Install the community package

    Open Settings, then Community nodes, and install the npm package n8n-nodes-businessmap in version 1.1.1. This step only exists on a self-hosted instance, whether you run n8n through Docker or npm, because n8n Cloud accepts verified community nodes only. After the install, Businessmap and Businessmap Trigger appear in the node panel like any built-in node.

  2. 02

    Create the credential once

    Go to the Credentials menu and create the Businessmap credential there, not inside a single workflow. A credential built this way is reused by every workflow on the instance, and each Businessmap node offers it in its dropdown. Both the action node and the trigger read the same entry, so one setup covers the 48 operations and the 18 events at once.

  3. 03

    Wire a first node and test it

    Drop a Businessmap node on the canvas, pick the credential, then choose a resource and an operation, mainCard.get with a known Card ID is the cheapest test. Run the node alone. A card coming back means the credential works. From there, replace the fixed Card ID with an expression such as {{ $json.card_id }} so the value flows in from the node before it.

Triggers

What starts a Businessmap workflow?

Businessmap Trigger is the node that starts a workflow when something happens in Businessmap. It listens to 18 events, listed below by family. Pick one or several, activate the workflow: n8n registers the webhook on your Businessmap account.

What you see in n8n

Every event, by family

One row per object, one chip per action. The event to tick in the node is object.action; hover a chip to read exactly when it fires.

All.*1
  • All.
    • All
Board Archived.*1
  • Board Archived.
    • Board Archived
Board Deleted.*1
  • Board Deleted.
    • Board Deleted
Board Renamed.*1
  • Board Renamed.
    • Board Renamed
Board Structure Changed.*1
  • Board Structure Changed.
    • Board Structure Changed
Card Archived.*1
  • Card Archived.
    • Card Archived
Card Created.*1
  • Card Created.
    • Card Created
Card Details Changed.*1
  • Card Details Changed.
    • Card Details Changed
Card Discarded.*1
  • Card Discarded.
    • Card Discarded
Card Moved.*1
  • Card Moved.
    • Card Moved
Card Restored.*1
  • Card Restored.
    • Card Restored
Card Unarchived.*1
  • Card Unarchived.
    • Card Unarchived
Comment Created.*1
  • Comment Created.
    • Comment Created
Comment Deleted.*1
  • Comment Deleted.
    • Comment Deleted
Comment Updated.*1
  • Comment Updated.
    • Comment Updated
Subtask Created.*1
  • Subtask Created.
    • Subtask Created
Subtask Deleted.*1
  • Subtask Deleted.
    • Subtask Deleted
Subtask Updated.*1
  • Subtask Updated.
    • Subtask Updated

Configuration notes

01Configure the Businessmap TriggerThe Businessmap Trigger, in version 1, starts a workflow when the tool calls n8n. It works by webhook, an URL that n8n registers with Businessmap when you activate the workflow, so each event lands within a few seconds and nothing is polled on a schedule.

The Businessmap Trigger, in version 1, starts a workflow when the tool calls n8n. It works by webhook, an URL that n8n registers with Businessmap when you activate the workflow, so each event lands within a few seconds and nothing is polled on a schedule.

Key parameters

  • Board Name or ID: the board the webhook is attached to, chosen from the list or given as an ID with an expression. It is required, and one trigger node watches one board.
  • Authenticate Incoming Webhook: a boolean that turns authentication on for incoming calls.
  • Events: the 18 events to subscribe to, grouped one per family, with All as the catch-all when you prefer to filter later in the workflow.
When to use it
any time the board is the source of truth and the workflow has to react to what people do on it.
02Card lifecycle eventsSeven of the 18 events follow a card from birth to retirement: Card Created, Card Details Changed, Card Moved, Card Archived, Card Unarchived, Card Discarded and Card Restored. Each one carries the card that changed, which gives the rest of the workflow a card identifier to work with.

Seven of the 18 events follow a card from birth to retirement: Card Created, Card Details Changed, Card Moved, Card Archived, Card Unarchived, Card Discarded and Card Restored. Each one carries the card that changed, which gives the rest of the workflow a card identifier to work with.

Two of them deserve a second look. Card Details Changed fires on edits to the card fields, so it catches a new deadline or a new owner without you subscribing to anything else. Card Discarded and Card Restored come as a pair, which lets a workflow undo what it did when somebody changes their mind.

Use cases
Card Moved feeding a stage change into a CRM, Card Created opening a matching folder in a drive, or Card Archived closing the linked ticket in a helpdesk. Pair a Card event with a Switch node when a single board serves several teams and only one lane matters.
03Comment eventsThree events cover the discussion happening on a card: Comment Created, Comment Updated and Comment Deleted. They fire on the comment itself, not on the card fields, so a workflow listening to them stays quiet while people edit titles and deadlines.

Three events cover the discussion happening on a card: Comment Created, Comment Updated and Comment Deleted. They fire on the comment itself, not on the card fields, so a workflow listening to them stays quiet while people edit titles and deadlines.

Keep in mind that a workflow posting comments with cards.comment will hear its own writing come back through Comment Created. A filter on the author right after the trigger is the usual way to stop that loop before it starts.

Use cases
mirroring a client comment into a shared channel so nobody has to open the board, or catching Comment Deleted on a regulated board to keep an audit copy elsewhere. A common pattern reads the comment, sends it to a language model for a short summary, then writes the summary back with cards.comment.
04Subtask eventsSubtask Created, Subtask Updated and Subtask Deleted react to the checklist inside a card rather than the card itself. Useful when the real unit of work is a step, not the card, which happens on boards where one card is a whole customer onboarding.

Subtask Created, Subtask Updated and Subtask Deleted react to the checklist inside a card rather than the card itself. Useful when the real unit of work is a step, not the card, which happens on boards where one card is a whole customer onboarding.

Subtask Updated is the busiest of the three, since it fires every time somebody ticks a box or edits a step, so a filter on the fields you care about keeps the executions readable. The card that owns the subtask travels with the event, which gives the workflow the card identifier it needs for any follow up operation.

Use cases
a checklist step marked finished triggering the next step through cards.subtask, or a deleted subtask raising a flag because the scope just shrank. Teams that bill per step often catch Subtask Updated and log the matching time with cards.logtime.
05Board eventsFour events watch the board as an object instead of its content: Board Renamed, Board Archived, Board Deleted and Board Structure Changed. The last one covers changes to the workflows, lanes and columns that every card operation depends on.

Four events watch the board as an object instead of its content: Board Renamed, Board Archived, Board Deleted and Board Structure Changed. The last one covers changes to the workflows, lanes and columns that every card operation depends on.

These four fire far less often than the card events, which makes them cheap to subscribe to and easy to review. They are also the only family that tells you something about the container rather than the work inside it.

Use cases
a governance alert when someone reshapes a production board, since a renamed column can quietly break a workflow that moves cards to a fixed Column Name or ID. Board Archived and Board Deleted are also the cue to stop the automations pointed at that board before they start failing.
Actions

What can the Businessmap node do?

The Businessmap node exposes 48 operations across 8 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.

Resources × operations matrix
ResourceCreateGet CardUpdateDeleteAdd AttachmentArchiveAssign TagBlockAdd CommentDiscardDownloadGet All BoardsGet All Cards Per BoardGet All StickersGet All TagsGet All WorkspacesGet Board DocumentsGet Board StructureGet Custom CardLinkLog TimeMoveRestoreSet Custom FieldsSet LocationCreate SubtaskUnarchiveUnblockUnlinkUpload
Main Card✓✓✓✓✓✓
Card✓✓✓✓✓✓✓✓✓✓✓✓
Attachment✓✓✓
Workspace✓✓✓✓
Board✓✓✓✓✓
Tag✓✓✓✓✓✓
Sticker✓✓✓✓✓✓
Document✓✓✓✓✓✓

Main Card

6 operations
01

Create card

mainCard.create

What you see in n8n

Notes & use cases

Creates a card and places it at an exact spot on the board, then returns it in the shape you asked for.

Key parameters

  • Board Name or ID, Workflow Name or ID, Lane Name or ID and Column Name or ID: the four required coordinates of the destination, each picked from a list or passed as an ID.
  • Title, Description, Priority (Critical, High, Average, Low), Deadline and Owner Name or ID: optional, and worth filling from the incoming item, for instance {{ $json.deadline }}.
Use cases
every inbound request becomes a card in the intake lane with its due date already set.
02

Update card

mainCard.update

What you see in n8n

Notes & use cases

Edits a card that already exists, leaving untouched every field you do not fill in.

Key parameters

  • Card ID: the numeric identifier of the card to edit, required, usually carried over from a trigger as {{ $json.card_id }}.
  • Board Name or ID: required here too, so the node knows which board the tags, stickers and card types belong to.
  • Workflow, Column and Lane Fields: an optional collection, handy when an edit also changes where the card sits.
Use cases
a deal amount changing in the CRM rewrites the card size and its priority in one run.
03

Move card

mainCard.move

What you see in n8n

Notes & use cases

Sends a card to another position without touching its content, which is the operation behind most stage changes.

Key parameters

  • Card ID: which card moves.
  • Board Name or ID, Workflow Name or ID, Lane Name or ID, Column Name or ID: the full destination, all four required, because a column alone is ambiguous on a board with several lanes.
Use cases
a signed quote in the billing tool pushes its card from Waiting to In progress, and the board reflects reality without anyone dragging anything.
04

Get card by ID

mainCard.get

What you see in n8n

Notes & use cases

Reads a single card from its numeric identifier and hands the result to the next node.

Key parameters

  • Card ID: the identifier of the card to get, required.
  • Output: simplified for a compact card, raw for everything the API returns, selected to choose.
  • Select Output Fields: the fields returned under selected, for example title, deadline and owner_user_id.
Use cases
refreshing a card before deciding whether to block it, so the workflow never acts on a stale copy.
05

Get card by custom card ID

mainCard.getCustom

What you see in n8n

Notes & use cases

Finds a card from the human readable reference your team writes on it, not from the numeric key.

Key parameters

  • Custom Card ID: the custom card ID of the card to get, a string, required.
  • Board Name or ID: optional, useful to narrow the search when the same reference pattern exists on several boards.
Use cases
an invoice or a support ticket carries a reference like PRJ-456 in its subject line, and the workflow finds the matching card without keeping a mapping table anywhere.
06

Get all cards per board

mainCard.getAllCardsPerBoard

What you see in n8n

Notes & use cases

Retrieves every card of a board in one run, which is the starting point of most exports and audits.

Key parameters

  • Board Name or ID: the board to read, required.
  • Select Output Fields: trim the payload here, because a board with hundreds of cards returned in raw makes the rest of the workflow slow to read and slow to debug.
Use cases
a nightly snapshot of the delivery board into a spreadsheet, keeping only the identifier, the title, the column and the current cycle time.

Card

12 operations
09

Set card custom fields

cards.setCustomFields

What you see in n8n

Notes & use cases

Writes the board specific fields of a card, the ones your team added on top of the standard card.

Key parameters

  • Card ID and Board Name or ID: both required, since custom fields are defined per board.
  • Custom Fields to Set: a resource mapper that loads the fields of that board and lets you map each one to a value from the incoming item.
Use cases
a contract number and a client segment coming from an ERP land in the card fields instead of being buried in the description.
10

Block card

cards.block

What you see in n8n

Notes & use cases

Flags a card as blocked with a documented reason, so the board shows where work is stuck.

Key parameters

  • Board Name or ID and Card ID: where the card lives and which card is blocked.
  • Block Reason Name or ID: picked from the reasons configured on that board.
  • Comment: required, and this is where the workflow explains itself, for instance the name of the missing document.
Use cases
a card whose client approval never arrived gets blocked automatically, with the reason visible to everyone.
11

Unblock card

cards.unblock

What you see in n8n

Notes & use cases

Clears the blocked flag of a card once the obstacle is gone, and the card resumes its normal path.

Key parameters

  • Card ID: the blocked card, required. When the selected action requires a board, make sure the card belongs to it.
  • Output: pick simplified if the next node only needs confirmation that the card is no longer blocked.
Use cases
the signed document finally lands in the shared drive, and the same workflow that blocked the card releases it minutes later.
12

Archive card

cards.archive

What you see in n8n

Notes & use cases

Takes a finished card off the active board while keeping it available, unlike a deletion.

Key parameters

  • Card ID: the card to archive, required.
  • Select Output Fields: include archived_at when the following node has to record when the card left the board.
Use cases
a weekly cleanup archives everything that has been sitting in the Done column for more than 8 days, so the board stays readable on a Monday morning.
13

Unarchive card

cards.unarchive

What you see in n8n

Notes & use cases

Brings an archived card back onto the board, in the position it had when it was archived.

Key parameters

  • Card ID: the archived card to bring back, required.
  • Output: raw is the safe choice here, because the state after an unarchive is exactly what you want to inspect in the execution log.
Use cases
a client reopens a request that was closed last month, and the original card comes back with its history rather than being recreated from scratch.
14

Discard card

cards.discard

What you see in n8n

Notes & use cases

Drops a card that will never be delivered, which is the honest ending for work that got cancelled.

Key parameters

  • Card ID: the card to discard, required.
  • Select Output Fields: discarded_at and discard_comment are the two fields worth returning when a report has to explain the cancellation later.
Use cases
an opportunity marked lost in the CRM discards its card, and the cycle time statistics stop counting work that never shipped.
15

Restore card

cards.restore

What you see in n8n

Notes & use cases

Undoes a discard and puts the card back among the live ones.

Key parameters

  • Card ID: the discarded card to restore, required. If the action you chose asks for a board, check that the card belongs to that board.
  • Output: selected keeps the response short when only the identifier matters downstream.
Use cases
a project put on hold in January starts again, and its card returns instead of a fresh one with no history attached.
16

Add comment to a card

cards.comment

What you see in n8n

Notes & use cases

Posts a comment on a card, which is the simplest way for a workflow to leave a trace people actually read.

Key parameters

  • Card ID: the card that receives the comment, required.
  • Comment: the text itself, required, entered as text or HTML, so a formatted summary built earlier in the workflow stays readable.
Use cases
the body of an inbound email is posted on the matching card, which spares the team the round trip to the mailbox.
17

Add subtask to a card

cards.subtask

What you see in n8n

Notes & use cases

Adds a checklist item inside a card, with its own owner and its own due date.

Key parameters

  • Card ID and Board Name or ID: the parent card and its board, both required.
  • Description: the subtask text, required, as text or HTML.
  • Deadline, Owner Name or ID and Subtask Status: optional, and the status lets you create a step already marked as finished.
Use cases
a new client card receives its five onboarding steps in one run, each assigned to the right person.
18

Log time to a card

cards.logtime

What you see in n8n

Notes & use cases

Records time spent on a card, which is what makes a board usable for billing or capacity checks.

Key parameters

  • Card ID: the card the time belongs to.
  • Time Unit and Duration: the unit and the amount, both required, so the same figure never gets read as minutes on one card and hours on another.
  • Date: the day the work happened, required, and Comment is optional.
Use cases
a calendar event tagged with a project reference logs itself on the matching card each evening.

Attachment

3 operations
19

Upload attachment to a card

attachments.upload

What you see in n8n

Notes & use cases

Attaches a file to a card from the binary data carried by the previous node.

Key parameters

  • Card ID: the card that receives the file, required.
  • File Name: the name the attachment will carry on the card, required, and a dynamic name such as {{ $json.reference }}.pdf beats a fixed one.
  • Content: the binary file data itself, required.
Use cases
a generated delivery report is attached to its card the moment the workflow finishes building it.
20

Download an attachment

attachments.download

What you see in n8n

Notes & use cases

Pulls a file already attached to a card back into the workflow as binary data.

Key parameters

  • Card ID: the card holding the file, required.
  • File Name or ID: the file to download, selected from the list or given as an attachment ID taken from Get Attachments, which is the usual way to chain the two operations.
Use cases
a signed purchase order is fetched from its card and forwarded to accounting without anyone opening the board.
21

Get card attachments

attachments.get

What you see in n8n

Notes & use cases

Lists the files attached to a card, with no other setting to think about.

Key parameters

  • Card ID: the card whose attachments you want, required, and it is the only parameter of this operation.
Use cases
a compliance check runs through the cards of a column and flags the ones missing a contract, then a second branch uses the returned attachment ID to download and archive each file elsewhere.

Workspace

4 operations
22

Create workspace

workspaces.create

What you see in n8n

Notes & use cases

Opens a new workspace, the container that later holds boards.

Key parameters

  • Workspace Name: the name of the workspace, required, and the only thing the operation cannot do without.
  • Type: optional, sets the type of the workspace when the default is not what you want.
Use cases
a new client signed in the CRM gets its own workspace before anyone opens the interface.
23

Update workspace

workspaces.update

What you see in n8n

Notes & use cases

Renames a workspace or flips its archive status, depending on which optional field you fill.

Key parameters

  • Workspace ID: the numeric identifier of the workspace to edit, required, in the form 12345.
  • Workspace Name: optional, and the way to keep naming in step with whatever system owns the client list.
  • Archive: optional, archives or unarchives the workspace in a single run.
Use cases
a project marked as closed in the planning tool archives its workspace the same night.
24

Get workspace

workspaces.get

What you see in n8n

Notes & use cases

Fetches one workspace and hands its payload to the branch that follows.

Nothing is written back, so the operation is safe to place anywhere in a branch that only needs context.

Key parameters

  • Workspace ID: the identifier of the workspace to read, required, and the single parameter here.
Use cases
a monthly report starts by reading the workspace so the export carries its real name rather than a raw identifier.
25

Get all workspaces

workspaces.getAllWorkspaces

What you see in n8n

Notes & use cases

Lists workspaces filtered on two required criteria instead of returning the whole account blindly.

Both filters are required, which keeps the result predictable even on an account that has grown over several years.

Key parameters

  • Type: required, searches for the selected type of workspaces.
  • Get All, Archived or Non-Archived: required, selects workspaces by archive status.
Use cases
a quarterly audit pulls the non archived workspaces and writes one row per workspace into Google Sheets.

Board

5 operations
26

Create board

boards.create

What you see in n8n

Notes & use cases

Adds a board inside a workspace you designate, ready to receive cards afterwards.

The board lands empty, so the run that follows usually assigns its tags and stickers straight away.

Key parameters

  • Workspace: required, selects the workspace the board belongs to.
  • Name: required, the name of the board, for instance My board.
  • Description: optional, useful to carry the context of the project the board serves.
Use cases
every won deal spawns a delivery board named after the account, with the scope pasted in the description.
27

Update board

boards.update

What you see in n8n

Notes & use cases

Rewrites the naming of a board, its description, or its archive status.

Key parameters

  • Board ID: the numeric identifier of the board to edit, required, in the form 9876.
  • Name and Description: optional, both left as they are when you leave them empty.
  • Archive: optional, archives or unarchives the board.
Use cases
a delivery board whose project reaches its end date is archived automatically at the end of the week.
28

Get board

boards.get

What you see in n8n

Notes & use cases

Returns a single board from its identifier, without touching anything on it.

It is the read that answers a single question, whether the board behind an identifier is the one the workflow expects.

Key parameters

  • Board ID: the identifier of the board to read, required, and the only field to fill.
Use cases
a workflow checks the board exists before it starts creating cards on it, and stops cleanly otherwise.
29

Get all boards

boards.getAllBoards

What you see in n8n

Notes & use cases

Walks through the boards of the account, with two optional filters to narrow the harvest.

Left without any filter, it simply returns what the credential can see, which is fine for a first exploration.

Key parameters

  • Workspace: optional, filters boards by workspace.
  • Show Archive: optional, decides whether archived boards come back in the list.
Use cases
a nightly inventory lists the boards of one workspace and stores them in Postgres for the reporting layer.
30

Get board structure

boards.getBoardStructure

What you see in n8n

Notes & use cases

Exposes how a board is built, which is what you read before moving anything into it.

The payload describes the layout rather than the content, so it stays useful even on a board whose cards change all day.

Key parameters

  • Board ID: the identifier of the board whose structure you retrieve, required.
Use cases
a workflow reads the structure once, keeps the identifiers it needs, and feeds them to a later move without asking anyone to look them up.

Tag

6 operations
31

Create tag

tags.create

What you see in n8n

Notes & use cases

Declares a new tag in the account, with an optional color to make it readable at a glance.

The tag exists at account level once created, and still has to be assigned to a board before any card wears it.

Key parameters

  • Label: required, the tag label, for instance Label.
  • Color: optional, sets the tag color in the #EEEEEE form.
Use cases
a new product line in the catalogue creates its tag before the first card that needs it exists.
32

Update tag

tags.update

What you see in n8n

Notes & use cases

Changes the label of an existing tag, and its color when you fill that field too.

Key parameters

  • Tag ID: required, the numeric identifier of the tag, in the form 12345.
  • Label: required on this operation.
  • Color: optional, and the quickest way to align a tag with a color code that was decided in another tool entirely, for instance the design system of the company.
Use cases
a wording change validated in the glossary reaches the tag on its own.
33

Delete tag

tags.delete

What you see in n8n

Notes & use cases

Erases a tag from the account.

There is no undo. The cards that carried the tag simply lose it, so a condition upstream is worth the extra minute it costs to build, especially on an account where several teams share the same tag list.

Key parameters

  • Tag ID: the identifier of the tag to delete, required, and the only parameter here.
Use cases
a cleanup workflow lists the tags, keeps the ones a rule declares obsolete, and deletes them one item at a time, leaving a trace of each removal in the execution log.
34

Get tag

tags.get

What you see in n8n

Notes & use cases

Looks up one tag, from its identifier or from its label, which is handy when only the wording travels between tools.

Key parameters

  • Tag ID/Label: required, the ID or label of the tag to get, for instance 12345 or Label Name.
  • Search By: optional, selects which of the two the lookup runs on.
Use cases
an incoming form sends a category as text, and this lookup turns it into the identifier the assignment needs.
35

Get all tags

tags.getAllTags

What you see in n8n

Notes & use cases

Hands back every tag the account knows, with nothing to configure at all.

This operation takes no parameter, which makes it the cheapest way to build a lookup table at the start of a run, and the natural companion of the assignment that comes later. Run it once per execution rather than once per card, and keep the result in memory.

Use cases
a workflow loads the tags once, then resolves each label locally in a Code node instead of calling the API for every card it processes.
36

Assign tag to a board

tags.assign

What you see in n8n

Notes & use cases

Makes an existing tag available on a board, a step you cannot skip before a card uses it there.

Assigning costs one call per pair, which a loop over the boards of a workspace handles without any extra logic.

Key parameters

  • Tag Name or ID: required, picked from the list or passed as an ID.
  • Board Name or ID: required, the board that receives the tag.
Use cases
a freshly created delivery board is provisioned with the standard tag set before the first card lands on it.

Sticker

6 operations
37

Create sticker

stickers.create

What you see in n8n

Notes & use cases

Registers a sticker with its wording, and a color when you want it to stand out.

Like a tag, a sticker is created once for the account and reused on as many boards as you assign it to.

Key parameters

  • Label: required, the sticker label, for instance Label.
  • Color: optional, set in the #EEEEEE form.
Use cases
a new severity level agreed by the support team becomes a sticker the same day it is decided.
38

Update sticker

stickers.update

What you see in n8n

Notes & use cases

Edits the wording of a sticker that already exists, and its color along the way.

Key parameters

  • Sticker ID: required, the numeric identifier, in the form 12345.
  • Label: required on this operation, so the sticker never ends up without wording.
  • Color: optional, left untouched when you leave it empty.
Use cases
a color convention revised for the new year is pushed onto the stickers in one pass over the list.
39

Delete sticker

stickers.delete

What you see in n8n

Notes & use cases

Wipes a sticker out of the account for good.

There is no undo on this one, so a run that deletes in bulk deserves a dry run branch that only logs what it would remove.

Key parameters

  • Sticker ID: the identifier of the sticker to delete, required, and nothing else to provide.
Use cases
a sticker replaced by a custom field disappears once the migration workflow has finished rewriting the cards.
40

Get sticker

stickers.get

What you see in n8n

Notes & use cases

Resolves a sticker from its identifier or from its label, whichever your incoming item carries.

Key parameters

  • Sticker ID/Label: required, the ID or label of the sticker to get, for instance 12345 or Label Name.
  • Search By: optional, tells the node which of the two to search on.
Use cases
a message received on Slack names a sticker in plain text, and this read turns it into something the board understands.
41

Get all stickers

stickers.getAllStickers

What you see in n8n

Notes & use cases

Enumerates the stickers of the account in one call.

No parameter to fill here either, which makes the operation a natural first step in a synchronisation run and an easy way to check what already exists before anything gets created. The response covers the account, not one board, so the assignment stays a separate decision.

Use cases
a comparison workflow reads the stickers, diffs them against a reference list held elsewhere, and only creates what is genuinely missing.
42

Assign sticker to a board

stickers.assign

What you see in n8n

Notes & use cases

Hooks a sticker onto a board so the cards of that board can carry it.

Assignment is per board, so the same sticker can equip one team and stay invisible on the boards of another.

Key parameters

  • Sticker Name or ID: required, chosen from the list or given as an ID.
  • Board Name or ID: required, the destination board.
Use cases
a board created for a new team inherits the sticker set of the team it was cloned from, sticker by sticker.

Document

6 operations
43

Create document

documents.create

What you see in n8n

Notes & use cases

Writes a document from the workflow, with content passed as text or HTML.

Key parameters

  • Title: required, the document title.
  • Content: optional, entered as text or HTML.
  • Additional Fields: optional collection with For Welcome, Is Archived, Is Important, Is Indexed for AI, Parent Doc ID and Show in Main Doc List.
Use cases
a meeting summary produced upstream lands as a document nested under the parent doc of the project.
44

Get a document

documents.get

What you see in n8n

Notes & use cases

Loads a single document by its identifier and passes it downstream.

Only the identifier travels, so this read pairs naturally with a trigger that already carries one and needs nothing else from the board it came from.

Key parameters

  • Document ID: required, the numeric identifier, in the form 123.
Use cases
a review workflow reads the document before deciding whether its content still matches what the board says.
45

Get board documents

documents.getBoardDocs

What you see in n8n

Notes & use cases

Gathers all the documents that live on one board.

The list comes back board by board, which makes it the entry point of any audit that walks the whole account.

Key parameters

  • Board Name or ID: required, the board whose documents to list.
Use cases
a handover checklist lists the documents of the board and emails the index through Gmail.
46

Update document

documents.update

What you see in n8n

Notes & use cases

Amends a document in place, keeping every field you leave empty as it is.

Key parameters

  • Document ID: required, the document to edit.
  • Title and Content: optional, and left as they are when empty.
  • Update Fields: optional collection with For Welcome, Is Archived, Is Important, Is Indexed for AI and Parent Doc ID.
Use cases
a specification kept in a repository is republished into the document at each merge, without a second copy appearing.
47

Set document location

documents.setLocation

What you see in n8n

Notes & use cases

Places an existing document on a card, on a board, or on both in the same call.

Key parameters

  • Document ID: required, the document to place.
  • Card ID: optional, the card that receives the document, left at 0 to skip.
  • Board Name or ID: optional, the board that receives it, left empty to skip.
Use cases
a contract generated at signature is attached to the card of the deal and to the board of the account at once.
48

Add attachment to document

documents.addAttachment

What you see in n8n

Notes & use cases

Uploads a file from the workflow and attaches it to a document.

Key parameters

  • Document ID: required, the document that receives the file.
  • File Name: optional, the name the file takes.
  • Binary Property: optional, the binary field name on the item, or an expression returning that name or the full binary object when the item no longer carries the file.
Use cases
a file dropped through a form is attached to the reference document of the project as soon as it arrives.
Need help

Need help automating Businessmap with n8n?

A person reads every message.

FAQ

Businessmap and n8n, common questions

01Is the Businessmap n8n integration free?
There is no cost on the n8n side, but there is a condition. Businessmap is a community node, which means it does not ship with n8n: you install the npm package n8n-nodes-businessmap, version 1.1.1, from Settings then Community nodes. That option exists on a self-hosted instance, running through Docker or npm, and n8n Cloud accepts verified community nodes only. n8n itself can be self-hosted or used on n8n Cloud, the hosted offer run by n8n, and a workflow behaves the same way on both. What Businessmap costs on its own side is a separate question this page does not cover.
02What credentials does the Businessmap node need?
One Businessmap credential, created once from the Credentials menu of n8n and then reused everywhere. Every node picks it from a dropdown, so the action node and the trigger share the same entry and you never paste a key into a workflow. The node exposes no authentication selector, there is a single credential type to fill in. On the trigger side, Authenticate Incoming Webhook is a separate boolean that turns authentication on for the calls Businessmap sends to n8n, which is worth enabling on an instance reachable from the internet.
03What are the limits of the Businessmap node in n8n?
The node covers 48 operations across 8 resources, so anything outside that list is simply not there. When you need such an endpoint, the HTTP Request node calls the Businessmap API directly and reuses the same credential through predefined authentication. Two other limits matter in practice. Read operations return what Output and Select Output Fields decide, so a missing field in the response usually means it was never selected. And the trigger attaches to a single board through the required Board Name or ID, so covering four boards means four trigger nodes in the workflow.
04Does the Businessmap trigger react in real time?
Yes. The trigger works by webhook, which means n8n registers an URL with Businessmap when you activate the workflow, and the tool calls that URL itself. Each of the 18 events arrives within a few seconds, and nothing is checked on a schedule. The practical consequence is the one that catches most people out: an inactive workflow has no registered webhook, so a test run on the canvas waits without ever receiving anything. Activate the workflow first, then act on the board selected in Board Name or ID.
05n8n or Make for Businessmap?
It depends on four things, and price is only one of them. Make is a hosted automation platform with no self-hosting option and billing per operation, so a workflow that reads a full board every hour has a cost that grows with the board. n8n can be self-hosted through Docker or npm, or used on n8n Cloud. For Businessmap specifically the hosting question decides a lot, since this community node only installs on a self-hosted instance unless it is verified. Data control follows the same line: self-hosting keeps card content on your own infrastructure.