Alloy Trigger

Overview

The Alloy trigger fires your procedure when decisioning or workflow events occur in your Alloy account — for example when an evaluation completes or a workflow finishes.

Setup

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

Webhook URL

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

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

Signature Verification

Rapidfolio verifies the X-Alloy-Signature header on every inbound request. Requests with an invalid or missing signature are rejected with a 400 response.

Rapidfolio handles the signature verification automatically when you connect your Alloy account — no additional configuration is required on your end.

Configuration

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

Supported Event Types

Event type	Description
evaluation.created	An evaluation was created and is being processed
evaluation.completed	An evaluation finished and a decision is available
workflow.completed	An Alloy workflow run completed

Payload

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

Evaluation completed

{
  "event": "evaluation.completed",
  "data": {
    "evaluation_token": "EVAL_123456789",
    "entity_token": "ENT_987654321",
    "outcome": "Approved",
    "timestamp": "2024-03-15T10:30:00.000Z",
    "journey_token": "JOURNEY_abc123",
    "journey_application_token": "APP_xyz789"
  }
}

Workflow completed

{
  "event": "workflow.completed",
  "data": {
    "workflow_token": "WF_abc123def456",
    "entity_token": "ENT_987654321",
    "outcome": "Approved",
    "timestamp": "2024-03-15T10:30:00.000Z"
  }
}

The data.outcome field contains the decision result (e.g. Approved, Denied, Manual Review). Use the Alloy integration steps in your procedure to retrieve full evaluation details using the evaluation_token.

Example Use Cases

• Automatically provision an account when evaluation.completed fires with an Approved outcome.
• Route an applicant to a manual review queue when evaluation.completed fires with a Manual Review outcome.
• Trigger a downstream compliance record when workflow.completed fires.
• Send a rejection notification when evaluation.completed fires with a Denied outcome.