# sumsub-manage-webhooks

Handles Sumsub webhook subscriptions inside sandbox environments. It lets agents inspect and configure verification event triggers via shell scripts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 7
- Author: sumsub
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-webhooks/SKILL.md
- Updated: 2026-10-02
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-manage-webhooks

## What it does

This skill handles event subscriptions for Sumsub verification flows, covering hooks like `applicantReviewed` and `applicantPending`. Fetch requests query `/resources/api/clientWebhooks`, while write operations go through `/resources/api/agent/clientWebhooks`. Routine execution is coordinated by `manage_webhooks.sh` together with `build_webhook_payload.py`.

Operations stay restricted to sandbox tenants. The utility actively checks tokens and declines any credential lacking the `sbx:` prefix. In addition, internal destinations like `localhost` fail validation immediately because Sumsub delivery infrastructure requires a target reachable from the public internet.

Public endpoints do not support deletion or delivery telemetry. When an endpoint is no longer needed or requires metric tracking, developers must perform those actions in the Sumsub cockpit UI.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-webhooks -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumsub-manage-webhooks/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumsub-manage-webhooks/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-webhooks -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumsub-manage-webhooks/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-webhooks -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumsub-manage-webhooks/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills sumsub-manage-webhooks
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-manage-webhooks/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-webhooks -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-manage-webhooks
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumsub-manage-webhooks/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-webhooks -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-webhooks/SKILL.md

## When to use it
- list registered sandbox webhook endpoints capped at 50 records
- add a public webhook endpoint for applicant status updates
- update secret tokens and event subscription lists on an existing ID
- validate webhook payload structures before production deployment

## Example prompts
- List all registered webhook listeners in my Sumsub sandbox
- Register a new webhook subscription using the parameters in `spec.json`
- Update the signing secret and event types for webhook ID 12345

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md