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. Arca is a verified node on n8n and is available directly in the node search, no manual installation required.

​
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.

​
Add the node

1

Search for Arca in n8n

In your n8n workflow, click + to add a node and search for Arca. The node is verified by n8n and appears directly in the search results, no manual installation needed.
2

Add credentials

When prompted for credentials, select the Arca API credential, 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

​
Workspace

​
Folder

​
List

​
Task

Priority values: urgent high medium low none

​
Status

Category values: pending in_progress completed cancelled

​
Label

​
Comment

​
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: 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:
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.