Skip to main content
The Arca n8n integration lets you build automated workflows that read from and write to your Arca workspaces. You can create tasks when events happen in other tools, update task statuses based on external triggers, post comments automatically, and much more. The integration ships as two nodes: an action node for performing operations and a trigger node for listening to events.

​
Requirements

You need a self-hosted or cloud n8n instance and an Arca API key. Any workspace member can generate an API key regardless of their role.

​
Get your API key

1

Open Settings

In Arca, click your avatar in the bottom-left sidebar and select Settings.
2

Go to API Keys

Select the API Keys section from the settings menu.
3

Generate a key

Click Add new key. Copy the key and store it somewhere safe. Arca only shows it once.

​
Install the node

1

Open n8n Settings

In your n8n instance, go to Settings → Community Nodes.
2

Install the package

Click Install, enter n8n-nodes-arca, and confirm. n8n downloads and registers the node automatically.
3

Add credentials

In any workflow, add a new Arca node. When prompted for credentials, select Arca API input field, paste your API key, and save. n8n verifies the key against your account before saving.

​
Arca node (actions)

The Arca node lets you perform operations on your workspace from any workflow step. Select a Resource and then an Operation to configure what the node does.

​
User

OperationWhat it does
Get Current UserReturns the profile of the account that owns the API key

​
Workspace

OperationWhat it does
List WorkspacesReturns all workspaces accessible to the API key
Get WorkspaceReturns the details of a specific workspace
List MembersReturns all members of a workspace

​
Folder

OperationWhat it does
List FoldersReturns all folders in a workspace
Create FolderCreates a new folder with an optional icon and color
Update FolderRenames or changes the icon and color of an existing folder
Delete FolderPermanently deletes a folder

​
List

OperationWhat it does
List ListsReturns all lists in a workspace
Create ListCreates a new list with an optional folder, icon, and color
Update ListRenames, moves, or reskins an existing list
Delete ListPermanently deletes a list

​
Task

OperationWhat it does
List TasksReturns tasks in a workspace, optionally filtered by list (paginated, 50 per page by default)
Get TaskReturns a single task by its ID
Create TaskCreates a task with title, description, priority, status, due date, and start date
Update TaskEdits any field on an existing task, including moving it to another list
Delete TaskPermanently deletes a task
Priority values: urgent high medium low none

​
Status

OperationWhat it does
List StatusesReturns all custom statuses in a workspace
Create StatusCreates a new status with a category, icon, and color
Update StatusEdits an existing status
Delete StatusDeletes a status, with an option to reassign tasks to another status first
Category values: pending in_progress completed cancelled

​
Label

OperationWhat it does
List LabelsReturns all labels in a workspace
Create LabelCreates a new label with an optional color
Update LabelRenames or recolors an existing label
Delete LabelPermanently deletes a label

​
Comment

OperationWhat it does
List CommentsReturns all comments on a task
Create CommentPosts a new comment on a task

​
Arca Trigger node

The Arca Trigger node starts a workflow whenever Arca sends a webhook event. It outputs the full event payload so downstream nodes can act on it.

​
Setup

1

Add the trigger node

Create a new workflow in n8n and add the Arca Trigger node as the starting node.
2

Copy the webhook URL

Click the node to open its settings. Copy the webhook URL shown in the panel (the production URL).
3

Register the webhook in Arca

In Arca, go to Settings → Webhooks, create a new webhook, and paste the n8n URL as the endpoint. Select the events you want to receive.
4

Activate the workflow

Back in n8n, publish the workflow. The trigger is now live and will start the workflow whenever a matching Arca event fires.

​
Supported events

The trigger accepts any event belonging to these resource types:
PrefixCovers
task.*Task created, updated, deleted, status changed, and more
folder.*Folder created, updated, deleted
list.*List created, updated, deleted
The trigger passes all events through. To react to a specific event type, add an IF or Switch node after the trigger and check the {{ $json.event }} value (for example task.created).

​
Output data

Each trigger execution outputs an object with the following fields:
FieldDescription
eventThe event type string, for example task.created
timestampISO 8601 timestamp of when the event occurred
workspaceThe workspace where the event happened
userThe Arca user who triggered the event
beforeThe resource state before the change (null for create events)
afterThe resource state after the change (null for delete events)
For more information about the event structure and available fields, see the Webhooks seciton.

​
Optional auth token

To verify that incoming webhook calls genuinely come from Arca, enable the Auth Token option in the Arca Trigger node settings and set a secret string. Then, in Arca’s webhook configuration, enter the same string in the Auth token field. The trigger rejects any request that does not present the correct token.

​
Use as an AI agent tool

The Arca node supports being used as a tool inside n8n AI agent workflows. Add it as a tool to any AI Agent node and the agent can query and update your Arca workspace using natural language instructions.

​
Limitations

Task listing returns 50 results per page by default. To retrieve more tasks, increment the Page parameter and loop until the result count drops below the page size. Comment operations are limited to listing and creating. Editing or deleting existing comments is not supported through n8n. Workspace operations are read-only. Creating or deleting workspaces must be done directly in Arca. There is no “get folder by ID” or “get list by ID” operation. Use the list operations and filter the results in your workflow.