sumsub-api-auth — Claude Code skill: what it does, install
This skill signs Sumsub API requests with HMAC-SHA256 and helps diagnose 401 errors. Use it for integration work or one-off request checks.
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-codeWhat sumsub-api-auth does
The skill covers Sumsub API authentication with an App Token and secret key. It builds X-App-Token, X-App-Access-Ts, and X-App-Access-Sig, using the HTTP method, request path with its query string, and the exact request body for the HMAC-SHA256 signature.
It includes scripts/sumsub_sign.py, which prints authentication headers without making a network call, and scripts/sumsub_curl.sh, which signs and sends a request with curl. The guidance also checks common causes of 401, such as an incorrect timestamp, method, path, or body bytes. A sandbox App Token and secret key are required; production credentials must not be used with Claude.
What it helps with
- sign a request to the Sumsub API
- debug a
401 Unauthorizedresponse - check authentication headers with
curl - create a signature for JSON or multipart data
Example prompts for the agent
- Sign a GET request to
/resources/applicants/-/countand show the required headers. - Find the cause of the
401 Invalid signatureresponse fromapi.sumsub.com. - Create a signing example for a
POSTrequest with query parameters and a JSON body.
How to install sumsub-api-auth
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-api-auth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-api-auth/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a codex2Manually: put the files in place
.agents/skills/sumsub-api-auth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a cursor2Manually: put the files in place
.cursor/skills/sumsub-api-auth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-api-auth2Manually: put the files in place
.github/skills/sumsub-api-auth/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-api-authManually: put the files in place
.devin/skills/sumsub-api-auth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-api-auth -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-api-auth
How do I install sumsub-api-auth in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-api-auth -a claude-code. The installed skill file is then available at ~/.claude/skills/sumsub-api-auth/SKILL.md.
What does sumsub-api-auth do?
It helps authenticate Sumsub API calls with an App Token, secret key, and HMAC-SHA256. The skill prepares the three auth headers and investigates common 401 causes.
What credentials does the skill require?
Use a sandbox SUMSUB_APP_TOKEN together with SUMSUB_SECRET_KEY. Store them in .env or .claude/settings.local.json; requests must use HTTPS.