Description
@praxicraft/n8n-nodes-assess
n8n community node for Praxicraft Assess — invite candidates, fetch results, manage pipelines and interviews, and react to signed webhooks. Thin wrapper over the Assess Public API.
npm scope: @praxicraft · Product docs: n8n setup · Automations · Webhooks
Install
Community nodes UI
1. Open n8n → Settings → Community nodes → Install
2. Enter package name:
@praxicraft/n8n-nodes-assess
3. Confirm. Restart n8n if your host requires it.
npm (self-hosted)
cd ~/.n8n
npm install @praxicraft/n8n-nodes-assess
Enable community packages per n8n’s installation docs.
Credentials
Add Praxicraft Assess API:
| Field | Value |
|——-|——–|
| API Key | ctlive… from Assess → Developer → API Keys |
| Base URL | https://assess.praxicraft.com (default; override for staging) |
Credential test calls GET /api/v1/public/org/ (needs organisation:read or full access).
Recommended scopes
| Use case | Scopes |
|———-|——–|
| Invite + result webhooks | assessments:read, invitations:write, candidates:read, webhooks:write |
| Pipeline enroll | pipelines:read, pipelines:write, webhooks:write |
Nodes
Praxicraft Assess Trigger
Starts a workflow when Assess delivers a signed webhook.
1. Select events (for example assessment.completed, candidate.passed).
2. Activate the workflow. The node registers its webhook URL with Assess, sends a test ping, and verifies X-Praxicraft-Signature.
3. Deactivate deletes the Assess webhook endpoint.
Supported events include assessment, candidate, invitation, pipeline, and interview lifecycle events. See Webhooks.
Praxicraft Assess (actions)
| Resource | Operations |
|———-|————|
| Assessment | List, Get, Create, Update, Duplicate, List Results, List/Attach/Replace/Remove Cases |
| Case | List, List Platform Cases, 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/update operations use form fields (not a raw JSON body). Bulk invite/enroll use a Candidates list UI. Template config remains a JSON object field because the API accepts arbitrary config.
#### Example: create an assessment
1. Resource Assessment → Create
2. Set Title (required), optional description / time limit / passing score
3. Use Additional Fields for proctoring flags or squad team_id
#### Example: invite a candidate
1. Resource Invitation → Invite
2. Set assessment slug, email, optional name
3. Enable Send Email if Assess should mail the invite link
#### Example: act on completion
1. Trigger on assessment.completed (payload includes invite_token)
2. Action Invitation → Get Result with that token (candidates:read)
Development
git clone https://github.com/praxicraft-platform/n8n-nodes-praxicraft-assess.git
cd n8n-nodes-praxicraft-assess
--ignore-scripts: n8n-workflow pulls isolated-vm; we only need TypeScript types
npm ci --ignore-scripts
npm test
npm run build
Release
Bump package.json (and CHANGELOG.md) in the PR so main always matches npm. After merge, push a matching tag — that triggers publish with provenance:
after merge, on main:
VERSION="$(node -p "require('./package.json').version")"
git tag -a "v${VERSION}" -m "Release v${VERSION}"
git push origin "v${VERSION}"
See RELEASING.md. Requires npm Trusted Publishing for @praxicraft/n8n-nodes-assess ↔ this repository (or NPM_TOKEN with publish rights on the @praxicraft org).
Before submitting to the n8n community verifier, run:
npx @n8n/node-cli@latest lint
npx @n8n/scan-community-package @praxicraft/n8n-nodes-assess
