sumsub-create-poa-preset — Claude Code skill
Creates and updates Sumsub Proof-of-Address presets through the API. Use it to define accepted documents, validity rules, and address checks.
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a claude-codeWhat sumsub-create-poa-preset does
This skill turns a compact specification into a Sumsub Proof-of-Address preset and sends it to the API. New presets use POST /resources/api/agent/poaStepSettings; existing ones use PATCH with the preset id in the request body. GET /resources/api/agent/poaStepSettings/{id} reads the current state. Helper scripts build the payload and handle create, update, and read operations.
The configuration can cover accepted document providers, validity periods, country scope, and matching between identity and address data. After creation, the returned id can be assigned to requiredIdDocs.docSets[].poaStepSettingsId on a level containing PROOF_OF_RESIDENCE.
Use sandbox credentials in SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY; the API also requires manageClientSettings. A production App Token is rejected, and the preset has no effect without a PROOF_OF_RESIDENCE step.
What it helps with
- create a Sumsub Proof-of-Address preset
- set accepted address documents and validity periods
- tune name and address matching between POI and POA
- apply country-specific POA rules
- edit an existing preset by
id
Example prompts for the agent
- Create a Sumsub POA preset for bank statements and utility bills.
- Update the existing Proof-of-Address preset with this
idand change its document validity. - Read the current POA preset and show the payload for the update.
How to install sumsub-create-poa-preset
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-create-poa-preset/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-create-poa-preset/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a codex2Manually: put the files in place
.agents/skills/sumsub-create-poa-preset/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a cursor2Manually: put the files in place
.cursor/skills/sumsub-create-poa-preset/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-create-poa-preset2Manually: put the files in place
.github/skills/sumsub-create-poa-preset/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-create-poa-presetManually: put the files in place
.devin/skills/sumsub-create-poa-preset/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -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-poa-preset
How do I install sumsub-create-poa-preset in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-create-poa-preset -a claude-code, then check ~/.claude/skills/sumsub-create-poa-preset/SKILL.md.
What does sumsub-create-poa-preset do?
It creates, reads, and updates Sumsub Proof-of-Address presets. The skill builds the request payload and uses the Sumsub API with POST, PATCH, and GET.
What is required to use the skill?
You need sandbox SUMSUB_APP_TOKEN, SUMSUB_SECRET_KEY, and the manageClientSettings permission. The preset must be connected to a level that contains a PROOF_OF_RESIDENCE step.
