influlist

n8n community node for Influlist: campaigns, tasks, subtasks, comments, talents, clients and statistics

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Influlist

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

  1. Go to Settings → Community Nodes → Install.
  2. Enter n8n-nodes-influlist.
  3. 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 createdSince or
    updatedSince respectively.
  • 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 null in 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 an error field 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 by
scripts/copy-assets.mjs, because n8n reads them next to the compiled node.

License

MIT

Discussion