Onfido Trigger

Overview

The Onfido trigger fires your procedure when identity verification events occur in your Onfido account — for example when a check completes, a report is ready, or a workflow run finishes.

Setup

Go to Connections in the Rapidfolio dashboard and connect your Onfido account.
Open the procedure you want to trigger and add an Onfido trigger.
Select the event types you want to listen for, then save the trigger.
Copy the generated webhook URL and register it in your Onfido Dashboard under Developers → Webhooks → Create webhook.

Webhook URL

https://run.rapidfolio.com/triggers/:triggerId/onfido

Replace :triggerId with the trigger ID shown in the Rapidfolio dashboard.

Signature Verification

Rapidfolio verifies the X-SHA2-Signature header on every inbound request using your Onfido webhook token. Requests with an invalid or missing signature are rejected with a 400 response.

Rapidfolio handles the HMAC-SHA256 signature verification automatically when you connect your Onfido account — you do not need to configure this manually.

Configuration

Field	Description
Connection	The Onfido connection to listen on
Event types	One or more Onfido event types to subscribe to (see below)

Supported Event Types

Event type	Description
`check.completed`	An applicant check (comprising one or more reports) has finished processing
`check.started`	A check has started and is being processed
`check.reopened`	A previously completed check was reopened
`report.completed`	An individual report within a check has completed
`report.withdrawn`	A report was withdrawn before completion
`workflow_run.completed`	A Studio workflow run has finished
`workflow_run.error`	A Studio workflow run encountered an error

Payload

The trigger payload is the raw Onfido webhook event body. Access it via the trigger input in your procedure.

Check completed

{
  "payload": {
    "resource_type": "check",
    "action": "check.completed",
    "object": {
      "id": "abc12345-def6-7890-ghij-klmnopqrstuv",
      "status": "complete",
      "result": "clear",
      "href": "https://api.onfido.com/v3/checks/abc12345-def6-7890-ghij-klmnopqrstuv"
    }
  }
}

Workflow run completed

{
  "payload": {
    "resource_type": "workflow_run",
    "action": "workflow_run.completed",
    "object": {
      "id": "abc12345-def6-7890-ghij-klmnopqrstuv",
      "status": "approved",
      "workflow_id": "wf_001",
      "applicant_id": "app_001",
      "href": "https://api.onfido.com/v3/workflow_runs/abc12345-def6-7890-ghij-klmnopqrstuv"
    }
  }
}

The payload.object.href field contains the API URL you can use with the Onfido integration steps in your procedure to fetch full resource details.

Example Use Cases

Automatically approve or reject an onboarding application when check.completed fires with a clear or consider result.
Trigger a manual review workflow when a report.completed event arrives with a non-clear outcome.
Update a customer's KYC status in your internal system when workflow_run.completed fires.
Alert your compliance team when a workflow run results in a declined status.