Flagright Trigger

Overview

The Flagright trigger fires your procedure when transaction monitoring, user, or case management events occur in your Flagright account. Use it to automate AML workflows — for example, escalating a flagged transaction to a human reviewer or updating a case in your internal system.

Setup

1. Go to Connections in the Rapidfolio dashboard and connect your Flagright account.
2. Open the procedure you want to trigger and add a Flagright 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 Flagright Console under Settings → Webhooks.

Webhook URL

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

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

Signature Verification

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

Rapidfolio handles signature verification automatically when you connect your Flagright account.

Configuration

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

Supported Event Types

Event type	Description
TRANSACTION_CREATED	A new transaction was ingested into Flagright
TRANSACTION_UPDATED	An existing transaction record was updated
USER_CREATED	A new user (consumer or business) was created in Flagright
USER_UPDATED	An existing user record was updated
ALERT_CREATED	A new AML alert was generated
ALERT_UPDATED	An existing alert was updated (e.g. status change)
CASE_CREATED	A new investigation case was opened
CASE_UPDATED	An existing case was updated

Payload

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

Alert created

{
  "eventType": "ALERT_CREATED",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "data": {
    "alertId": "alert_abc123def456",
    "alertType": "TRANSACTION_MONITORING",
    "riskScore": 87,
    "status": "OPEN",
    "transactionId": "txn_xyz789",
    "userId": "user_001",
    "rules": [
      {
        "ruleId": "rule_structuring",
        "ruleName": "Possible structuring detected",
        "severity": "HIGH"
      }
    ]
  }
}

Case created

{
  "eventType": "CASE_CREATED",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "data": {
    "caseId": "case_abc123def456",
    "status": "OPEN",
    "assignedTo": "analyst@example.com",
    "relatedAlerts": ["alert_abc123def456"],
    "userId": "user_001"
  }
}

Transaction created

{
  "eventType": "TRANSACTION_CREATED",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "data": {
    "transactionId": "txn_xyz789",
    "userId": "user_001",
    "amount": 9500,
    "currency": "USD",
    "type": "DEPOSIT",
    "status": "SUCCESSFUL",
    "timestamp": "2024-03-15T10:29:55.000Z"
  }
}

Example Use Cases

• Route high-risk alerts to a human reviewer in the Rapidfolio dashboard when ALERT_CREATED fires with a risk score above a threshold.
• Automatically create a case in your internal system when a Flagright CASE_CREATED event arrives.
• Trigger a customer notification or account restriction workflow when a USER_UPDATED event indicates a status change.
• Log and enrich transaction records in your data warehouse when TRANSACTION_CREATED fires.