Workflow Nodes

Internal tools for completing, failing, and managing workflow node execution.

Tools (4)

complete_node

Full name: campaignstack_complete_node

workflows:write Idempotent

Report successful completion of a workflow node for a lead. Marks the lead entry as COMPLETED, pushes the lead to the next node(s) via edges, and logs the action for audit. Returns the IDs of next nodes the lead was pushed to.

Parameters

Name	Type	Required	Default	Description
entryId	string	Yes	—	(min length: 1)
nodeId	string	Yes	—	(min length: 1)
workflowId	string	Yes	—	(min length: 1)
leadId	string	Yes	—	(min length: 1)
payload	object	No	—
linkedinAccountId	string	No	—

---

fail_node

Full name: campaignstack_fail_node

workflows:write Idempotent

Report failure of a workflow node for a lead. Marks the lead entry as FAILED with an error message. For auth_expired: reverts lead to WAITING and marks LinkedIn account as expired. For rate_limit: auto-pauses the action type with a 1-hour cooldown. Use campaignstack_complete_node for successful completions.

Parameters

Name	Type	Required	Default	Description
entryId	string	Yes	—	(min length: 1)
nodeId	string	Yes	—	(min length: 1)
workflowId	string	Yes	—	(min length: 1)
leadId	string	Yes	—	(min length: 1)
error	string	Yes	—	(min length: 1)
errorType	auth_expired | rate_limit | not_connected | generic	No	—
linkedinAccountId	string	No	—

---

store_conversation

Full name: campaignstack_store_conversation

workflows:write Idempotent

Store sent/received LinkedIn messages in the conversations table. Deduplicates against existing messages (same sender + text within 60s = skip). Creates a new conversation if none exists for the linkedinAccountId + leadId pair. Returns the number of messages stored and skipped.

Parameters

Name	Type	Required	Default	Description
leadId	string	Yes	—	(min length: 1)
linkedinAccountId	string	Yes	—	(min length: 1)
workflowId	string	Yes	—	(min length: 1)
messages	object[]	Yes	—

---

extract_post_engagements

Full name: campaignstack_extract_post_engagements

content:write

Extract all engagement data (reactions, comments, reposts) from a LinkedIn post. Must be called AFTER using browser tools to click reactions count, repost count, and sorting comments to ‘Most Recent’. The extraction reads intercepted API data from the current browser session and scrapes via Voyager GraphQL. Returns counts of extracted reactions, comments, and reposts.

Parameters

Name	Type	Required	Default	Description
postUrl	string	Yes	—	(min length: 1)
authorName	string	No	—
contentSnippet	string	No	—
reactionCount	number	No	—
commentCount	number	No	—

---