oneteam

n8n nodes for Oneteam: listen to webhook events and run organisation operations

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.0
Author: Oneteam

Available Nodes

Documentation generating…

Oneteam icon
Oneteam
Run operations in Oneteam
Oneteam Trigger icon
Oneteam Trigger
Starts the workflow when an Oneteam webhook event is received

Documentation

n8n-oneteam

n8n community nodes for Oneteam.
service-account tokens (sa_…), REST-hook webhooks, invite/update employee, memberships, organization messages.

The GitHub repo is n8n-oneteam. The npm package is n8n-nodes-oneteam (n8n requires the n8n-nodes- prefix to install from the UI).

What is in here

n8n piece What it does Oneteam API
Credential Oneteam API sa_… token + optional base URL GET /v1/organisations
Oneteam Trigger Subscribe to an event POST/DELETE /v1/organisations/{id}/webhooks
New Form Submission Optional form filter + hydrate answers GET …/forms/{id}/submissions/{id}
Course Completed Optional course filter GET …/courses
Task Created / Task Assigned Task webhooks POST/DELETE …/webhooks
Oneteam → Invite / Update employee Creates / updates a user POST/PUT /v2/organisations/{id}/users
Oneteam → Membership Add/remove network, function, team PUT …/users/{id}/networks|functions|teams
Oneteam → Organization message Post an organization message POST …/organisation_messages
Oneteam → Form List forms, list or get submissions, update submission status GET …/forms, GET …/forms/{id}/submissions, PATCH …/forms/{id}/submissions/{id}/response_status
Oneteam → Task → List List tasks in the organisation GET …/forms?type=task
Oneteam → Task → Create One-time or recurring, individually or as a team, audience, questions POST /v1/…/forms with form_type: task, POST …/screens for questions, then PUT …/forms/{id} to publish
Oneteam → Task → Update status Set the response status of a task submission PATCH …/tasks/{id}/submissions/{id}/response_status
Oneteam → Push notification Send a push to one employee POST …/notifications
Oneteam → Chat message Send a private message. Attachment is an existing Oneteam file id POST …/chat/messages
Oneteam → Course List courses GET …/courses
Oneteam → Onboarding Statistics and user progress GET …/onboarding/statistics
Oneteam → Analytics Organisation metrics, counts, users, networks GET …/analytics

user.anonymized is not offered as a trigger.

Local development

nvm use 24
npm install
npm run build
npm run start:n8n

n8n@latest (2.x) needs Node 24 — run nvm use 24 (or nvm use; .nvmrc pins 24) before start:n8n.

Open http://localhost:5678 (not 127.0.0.1). Local HTTP needs
N8N_SECURE_COOKIE=false — Safari will block the default secure cookie even on
localhost. start:n8n sets that and loads compiled nodes from dist
(N8N_CUSTOM_EXTENSIONS=./dist — not ., or n8n 2.x also scans node_modules).

Then add credentials:

  1. Organisation Settings → Service Accounts
  2. Scopes: webhooks.manage, forms.view-report, forms.create, forms.update-submission, users.create, users.view, users.manage, organisation-messages.create, onboarding.statistics, analytics.view, tasks.create, tasks.update, notifications.send, chat-messages.create

Listing forms and courses works for any service account. Reading form answers still needs forms.view-report.
3. Token starts with sa_

Base URL defaults to https://api.oneteam.io. Use your API host for staging.

Service account token

Every action in this node runs on a service-account token (sa_…).

  • Task → Create needs forms.create. The form, its questions and the
    publish step are attributed to the user who created the service account.
  • Employee pickers need users.view (GET /v2/organisations/{id}/users).
    users.manage also grants the list. Bearer responses include id, name and
    email only.
  • Reading a form, including its response statuses, needs forms.view-report.

Relation to other repos

Discussion