Description
@skhema/n8n-nodes-skhema
An n8n community node for Skhema — the
strategy platform. Trigger workflows when people join your organization or
workspaces, and create workspaces, strategy elements, and compliance
completions from any n8n workflow.
The node mirrors Skhema’s Zapier and Make integrations exactly (same triggers,
actions, field semantics, and output shapes), so an automation recipe built on
one platform replicates on the others.
Installation · Credentials · Triggers · Actions · Example · Resources
—
Installation
Follow the n8n community nodes installation guide:
in your n8n instance, go to Settings → Community Nodes → Install and enter
@skhema/n8n-nodes-skhema.
Self-hosted n8n requires Node.js 20.19–24.
Credentials
The node authenticates with Skhema OAuth2 (Authorization Code + PKCE, as a
public client — no client secret). A connection represents your Skhema
organization.
1. In Skhema, have an organization owner or admin register your n8n
instance’s OAuth callback URL under Connections:
https://
(for n8n Cloud: https://).
Skhema refuses OAuth flows targeting unregistered callbacks — this is what
ties a connection to your instance.
2. Add a new Skhema OAuth2 API credential in n8n. The Client ID is
prefilled (Skhema’s shared public client) and there is no secret to enter;
the endpoints and scopes are pre-configured.
3. Click Connect and authorize as an organization admin or owner, selecting
the organization the connection should act for.
> Upgrading to 0.3.0: delete and re-create your Skhema credential. Saved
> credentials keep the previous authorization endpoints, which no longer exist,
> and tokens issued by them can no longer be refreshed.
Trigger node — Skhema Trigger
Instant, webhook-backed trigger — no polling. Subscriptions are registered
automatically when the workflow is activated and removed when it is
deactivated. Pick one or both events:
| Event | Fires when | Payload highlights |
| ———————— | ——————————– | —————————————————————————————— |
| New User | a member joins your organization | username, useremail, role, joined_at |
| New Workspace Member | a member joins a workspace | the above plus workspaceName, membership source, and pendingCompliance (see example) |
The New Workspace Member event also carries haspendingcompliance,
pendingcompliancecount, and pendingcompliancenames — flat fields that
are easy to filter on. An optional Workspace parameter restricts the trigger to
a single workspace; leave it empty to fire for every workspace in the
organization.
Action node — Skhema
| Resource | Operation | What it does |
| ———- | —————————— | ————————————————— |
| Workspace | Create | Create a workspace (name, visibility) |
| Workspace | Find | Find a workspace by name or ID |
| Element | Create | Create a strategy element in a workspace |
| Compliance | Find Requirement | List a workspace’s compliance requirements |
| Compliance | Complete Member Compliance | Mark a member’s compliance requirement as satisfied |
Create Element understands Skhema’s component → element-type structure: the
element-type options scope to the chosen component. Workspace, member, and
requirement fields accept values from dropdowns or — the common pattern —
mapped expressions from a trigger, e.g.
{{ $json.newState.workspaceMemberId }}.
Example: compliance hand-off
Automate workspace compliance (e.g. NDAs) end to end:
1. Skhema Trigger — New Workspace Member, filtered on
haspendingcompliance being true.
2. Your e-signature node (PandaDoc, DocuSign, …) sends the document to
user_email.
3. On completion, Skhema — Complete Member Compliance marks the requirement
satisfied — mapping workspaceId, newState.workspaceMemberId, and
metadata.pendingCompliance[0].id straight from the trigger.
The trigger payload carries everything the completion action needs, so the
Skhema side of the workflow is exactly two nodes.
Compatibility
- n8n on Node.js 20.19–24 (self-hosted)
- Tested against n8n 2.x
- Skhema · Skhema API documentation
- n8n community nodes documentation
