assess

n8n community node for Praxicraft Assess — invite candidates, fetch results, pipelines, interviews, and signed webhooks via the Public API

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.3
Author: Praxicraft

Available Nodes

Documentation generating…

Praxicraft Assess icon
Praxicraft Assess
Full Praxicraft Assess Public API wrapper (assessments, tasks, invites, pipelines, interviews, webhooks)
Praxicraft Assess Trigger icon
Praxicraft Assess Trigger
Starts the workflow when Assess sends a signed webhook event

Documentation

Praxicraft Assess for n8n

Official n8n community node for Praxicraft Assess.

Invite candidates, fetch results, manage hiring pipelines and interviews, and react to signed Assess events — on n8n Cloud or self-hosted n8n. No custom webhook code required.

Package: @praxicraft/n8n-nodes-assess

Requires an n8n account (Cloud or self-hosted) and an Assess API key (Starter+). Product docs: docs.praxicraft.com/integrations/n8n

Table of Contents

Install

n8n Cloud or Community nodes UI

Works on n8n Cloud and self-hosted n8n.

  1. Open n8n → Settings → Community nodes → Install
  2. Enter package name:
@praxicraft/n8n-nodes-assess
  1. Confirm. On self-hosted, restart n8n if your host requires it.

On Cloud you can also install from the canvas: search Praxicraft while adding a step, open the node, and click Install.

Setup guide

1. Create a workflow

Open n8n and create a new workflow. Click Add first step… on the canvas.

Empty n8n workflow canvas with Add first step button

2. Open the trigger picker

n8n opens What triggers this workflow? Choose On app event (or search for the node directly).

n8n sidebar asking what triggers this workflow

3. Search for Praxicraft Assess

Type prax (or Praxicraft) in the search box. Select Praxicraft Assess. The verified checkmark means it is the official Assess node.

n8n search for prax showing Praxicraft Assess with verified badge

4. Confirm the verified node

Open the node details. You should see Verified, Installed (or Install), and the list of Assess triggers and actions.

Praxicraft Assess node details showing verified badge and trigger list

If the node is not installed yet, use Install from this panel (n8n Cloud) or install the package from Settings → Community nodes, then restart if needed.

5. Add credentials

  1. Create an API key in Assess (Developer → API Keys).
  2. On any Praxicraft Assess node, open Credential to connect with → Create new credential.

n8n List assessments node showing credential dropdown with Create new credential

  1. Paste your API key. Live keys start with ct_live_; test keys start with ct_test_. Leave Base URL as https://assess.praxicraft.com unless you use a custom host.
  2. Save. n8n tests the credential automatically.

n8n credential form for Praxicraft Assess API with API Key and Base URL fields

6. Build and run

Trigger path: pick an event (for example On candidate passed) → connect Slack, email, or your ATS.

Action path: start from a manual trigger or ATS webhook → add Praxicraft Assess → choose an action such as List assessments.

n8n workflow with manual trigger connected to Praxicraft List assessments action

7. Activate

Turn the workflow Active. For Trigger nodes, n8n registers a webhook with Assess, runs a test ping, and verifies signatures for you.

Authentication

Create an organisation API key in Assess:

Assess → Developer → API Keys → create key → copy ct_live_… or ct_test_… (shown once).

In n8n, add a Praxicraft Assess API credential:

Field Value
API Key Your ct_live_… or ct_test_… key
Base URL https://assess.praxicraft.com (default)

Never commit API keys. Prefer a dedicated key for n8n and rotate it if it leaks.

Recommended scopes

Use case Scopes
Invite + notify on results assessments:read, invitations:write, candidates:read, webhooks:write
Pipeline enroll pipelines:read, pipelines:write, webhooks:write

Scopes and rotation: Authentication · Scopes

What you can do

Praxicraft Assess Trigger

Starts a workflow when Assess delivers a signed event (for example assessment.completed, candidate.passed, pipeline moves, interview lifecycle). Activate the workflow to register the webhook; deactivate to remove it.

Event catalog: Webhooks

Praxicraft Assess (actions)

Resource Common actions
Assessment List, Get, Create, Update, Duplicate, List Results, Attach / Replace / Remove Tasks
Task List org tasks, List platform tasks, Create, Get, Update, Delete
Invitation List, Invite, Bulk Invite, Get, Get Result, Remind, Cancel
Pipeline List, Get, Enroll, Bulk Enroll, List / Get Enrollment, Reject, Hold, Unhold
Webhook List, Create, Get, Update, Delete, List Deliveries, Test
Organisation Get, Stats, List Team, Squads, Audit Log
Interview List, Create, Bulk Create, Get, Cancel, Reschedule, Analysis, Replay, Share, Templates
Integration List, Get Connect URL, Test

Create and update steps use form fields. Bulk invite and enroll use a candidates list. Dropdowns cover assessments, tasks, invitations, pipelines, and more — you can still map an id from a previous step.

Example workflows

Invite a candidate

  1. Resource Invitation → Invite
  2. Set assessment, email, optional name
  3. Enable Send Email if Assess should mail the take link

Notify Slack when someone passes

  1. Trigger On candidate passed
  2. Add a Slack (or email) step with the candidate name and score from the event payload

Act on completion

  1. Trigger on assessment.completed (payload includes invite_token)
  2. Action Invitation → Get Result with that token

More recipes: Automations · praxicraft-assess-examples

Troubleshooting

Symptom Fix
Credential test fails Add organisation:read or use full-access scopes
Trigger never fires Workflow must be Active; webhook must verify
403 INSUFFICIENT_SCOPE Widen key scopes — Scopes
Node missing in search Install @praxicraft/n8n-nodes-assess and refresh / restart n8n
Signature failures Do not rewrite the raw request body in a proxy

Error codes: Errors

Requirements & support

Contributors and maintainers: see CONTRIBUTING.md.

License

MIT

Discussion