Package Information
Documentation
n8n-nodes-influlist
Community node for Influlist. It exposes the
agency workspace over the app's REST API: campaigns, tasks, subtasks, comments,
members, clients and the dashboard summary, plus a polling trigger.
Requirements
- An Influlist deployment reachable from the n8n instance.
- An API key created in Settings → API Keys. The key is shown once, at
creation time.
Keys carry scopes:
| Scope | Allows |
|---|---|
read |
Every Get and Get Many operation |
read,write |
The above plus Create, Update and Delete |
A key acts as the person who created it, inside its organization. Visibility
follows the same rules as the web app: a talent key sees only its own campaigns,
tasks and profile, and never sees budget, profit, invoices or the roster unless
the campaign shares them.
Installation
Self-hosted, via the community nodes panel
- Go to Settings → Community Nodes → Install.
- Enter
n8n-nodes-influlist. - Accept the risk prompt and install.
Self-hosted, from a local build
cd n8n-nodes-influlist
npm install
npm run build
Then point n8n at the folder:
export N8N_CUSTOM_EXTENSIONS=/absolute/path/to/n8n-nodes-influlist
Restart n8n. Both the Influlist node and the Influlist Trigger appear in
the node panel.
Credentials
Create an Influlist API credential:
- Base URL — the root of your deployment. Defaults to
https://influlist.blacksilla.com. No trailing slash needed; it is stripped. - API Key — the
infl_...value from the settings page.
The credential test calls GET /api/v1/me, so a wrong base URL, a revoked key or
a key whose owner left the organization fails immediately.
Operations
Campaign
| Operation | Notes |
|---|---|
| Create | Title, status, currency, billing mode, commission, budget, dates, client, managers and the talent roster with per-talent price and commission |
| Get | Full campaign including resources. Private resources of other talents are omitted |
| Get Many | Filters: status, client, manager, talent, search, updated since, created since |
| Update | Every field is optional. Leave a field empty to keep the current value |
| Delete | Managers and owners only. Tasks, subtasks and comments cascade |
Task
| Operation | Notes |
|---|---|
| Create | Campaign, title, platform, status, deadline, assignee, deliverable URL |
| Get | Task with assignee, creator, campaign and counters |
| Get Many | Filters: campaign, status, assignee, platform, search, due before/after, updated since, created since |
| Update | Assignee or a manager may move a task; only managers reassign and delete |
| Delete | Managers only |
Subtask
| Operation | Notes |
|---|---|
| Create | Adds a checklist item to a task |
| Get Many | Lists the checklist of one task |
| Update | Rename or tick off |
| Delete | Removes the item |
Comment
| Operation | Notes |
|---|---|
| Create | On a task or on the campaign itself |
| Get Many | Thread of a task or a campaign |
| Delete | Authors delete their own; managers moderate the rest |
Member
| Operation | Notes |
|---|---|
| Get | One member. A talent key can only read its own record |
| Get Many | Filters: role and search. A talent key gets only itself |
Client
| Operation | Notes |
|---|---|
| Create | Name, logo, website, notes and contact people |
| Get / Get Many | Agency keys only |
| Update | Sending contacts replaces the list; omitting it keeps the current one |
| Delete | Owner only |
Statistics
Get Summary returns campaign and task counters by status, the financial totals
and how many completed campaigns are still unpaid. Optionally scoped to one
campaign.
Trigger
Influlist Trigger polls for new campaigns, tasks and comments.
- Campaign / Task → Created or Updated — uses
createdSinceorupdatedSincerespectively. - Comment — always creation, and it follows the whole conversation of the
chosen campaign, including comments written on its tasks.
On activation the trigger records the current moment as its checkpoint and
emits nothing, so history does not flood the workflow. From then on every poll
advances the checkpoint to the newest row it delivered. A manual test run looks
back one day.
Behaviour worth knowing
- Responses are unwrapped: one item per record. A list operation with
Return All disabled returns at most Limit items, 200 maximum per page. - Send the literal text
nullin a text field to clear a nullable column, such
as a client, an invoice URL or a deliverable link. Leave the field empty to
keep the current value. - Errors surface the API message, for example
Only the campaign's managers can delete a task.Enable Continue On Fail
to keep the workflow running with anerrorfield on the output item.
Development
npm install
npm run build # tsc, then copies the SVG icons into dist/
npm run typecheck
npm run dev keeps tsc watching. Assets are copied byscripts/copy-assets.mjs, because n8n reads them next to the compiled node.
License
MIT