sumsub-create-level — Claude Code skill: build Sumsub levels via API
Turns a short list of verification steps into a Sumsub applicant level, posts it to the API and shows what the server actually kept.
npx skills add sumsub/agent-skills --skill sumsub-create-level -a claude-codeWhat sumsub-create-level does
The skill maps a plain list of checks — documents, selfie, proof of residence, questionnaire, KYB, e-sign — onto an ApplicantLevel body. New levels go out with POST /resources/applicants/-/levels, updates with PATCH on the same path and the id in the body, and GET /resources/applicants/-/levels/{id} reads a level back for comparison.
Scripts do the work: build_level.py turns a spec on stdin into the payload, while post_level.sh, patch_level.sh and get_level.sh talk to the API. Before the first POST the skill prints the resolved body and waits for your confirmation. You need SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY, and the token has to be a sandbox one — the helper rejects anything that does not start with sbx:. That is deliberate: creating a level writes to the whole workspace, so a production token is refused rather than quietly accepted.
Step 0 fetches tenant entitlements through sumsub-check-permissions and every feature-gated step is checked against them. A PROOF_OF_RESIDENCE step without a poaPresetId gets rejected by the server, so a preset may need creating first. On update, PATCH swaps the requiredIdDocs.docSets array as a whole — any field missing from a docSet you send is wiped server-side.
What it helps with
- build a verification level from a list of steps
- update an existing level without dropping fields
- read a level back and diff it against what was sent
- check whether tenant entitlements cover a step
- wire a questionnaire step to a specific questionnaireDefId
Example prompts for the agent
- create a Sumsub level with ID document, selfie and proof of residence
- update the level and add a questionnaire step
- show me what the Sumsub level currently contains
How to install sumsub-create-level
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-level -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-create-level/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-create-level/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-level -a codex2Manually: put the files in place
.agents/skills/sumsub-create-level/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-level -a cursor2Manually: put the files in place
.cursor/skills/sumsub-create-level/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-create-level2Manually: put the files in place
.github/skills/sumsub-create-level/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-level -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-create-levelManually: put the files in place
.devin/skills/sumsub-create-level/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-level -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumsub-create-level
How do I install sumsub-create-level in Claude?
Run npx skills add sumsub/agent-skills --skill sumsub-create-level -a claude-code. The skill lands in ~/.claude/skills/sumsub-create-level/SKILL.md.
What does sumsub-create-level do?
It builds a Sumsub applicant level payload, creates or updates it through the API, then reads it back and reports any mismatch.
What credentials does the skill need?
A sandbox App Token in SUMSUB_APP_TOKEN and its paired secret in SUMSUB_SECRET_KEY. The token must start with sbx: — the script rejects production tokens.
