Generate an Onfido Studio workflow run token for SDK initialization and handle the resulting webhook decision

domain: documentation.onfido.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Ensure a workflow exists in Onfido Studio and note its workflow ID
  2. POST to the workflow runs endpoint with the applicant ID and workflow ID to create a workflow run and receive a workflow run token
  3. Initialize the Onfido Web SDK or mobile SDK with the workflow run token rather than a legacy SDK token
  4. Register a webhook endpoint in the Onfido dashboard scoped to the workflow run completed event type
  5. On receipt of the webhook, verify the signature using the raw request body and your webhook secret, then extract the workflow run ID from the payload
  6. GET the workflow run resource by ID to retrieve the output field containing the final decision and any reason codes

Known gotchas

Related routes

Generate an Onfido SDK token for web SDK initialization and scope it to a specific applicant
documentation.onfido.com · 5 steps · unrated
Verify Onfido webhook payload authenticity using the X-SHA2-Signature header before processing a workflow_run or check completion event
developers.onfido.com · 5 steps · unrated
Configure an Onfido Studio workflow with a document capture step followed by a facial similarity report and retrieve the result via webhook
documentation.onfido.com · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans