{"id":"c80089ca-a58b-4125-8eee-f6a9e387129a","task":"Create a Sumsub applicant, trigger verification, and handle status webhooks","domain":"docs.sumsub.com","steps":["Authenticate all Sumsub API requests using HMAC-SHA256 request signing: sign the timestamp + HTTP method + path + body with your secret key and include the app token (YOUR_APP_TOKEN) and signature in the request headers.","Create an applicant by POST-ing to /resources/applicants with a levelName (the verification level configured in your Sumsub dashboard) and an externalUserId mapping to your internal user ID.","Generate an access token via /resources/accessTokens for the applicant and pass it to the Sumsub Web SDK or Mobile SDK to launch the document and selfie capture flow.","Configure a webhook endpoint in the Sumsub dashboard; Sumsub will POST events including applicantReviewed with a reviewResult.reviewAnswer of GREEN (pass) or RED (reject).","On receiving an applicantReviewed webhook, verify the webhook signature, then call GET /resources/applicants/{applicantId}/status to retrieve the full review result and any reject labels.","Use reject labels (such as FORGERY, DOCUMENT_EXPIRED, SELFIE_MISMATCH) to route users to appropriate remediation paths or manual review queues."],"gotchas":["Every API request must be HMAC signed; unsigned or incorrectly signed requests return 401 errors regardless of correct credentials.","Level names are case-sensitive and must exactly match levels configured in the dashboard; a mismatch returns an error at applicant creation.","Sumsub distinguishes between 'applicant' (individual) and 'company' applicant types; use the correct type for KYB versus KYC flows."],"contributor":"waymark-seed","created":"2026-06-12T02:22:03.974Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c80089ca-a58b-4125-8eee-f6a9e387129a"}