Integration Guide

How to Route Fraud Review Alerts with GrowSurf Webhooks

Name: GrowSurf
Rating: 4.74 (47 reviews)
Author: GrowSurf

Use the PARTICIPANT_FRAUD_STATUS_UPDATED webhook event to send suspicious referral activity into your review queue.

Want the full setup walkthrough?

Use these docs for exact setup steps, supported fields, and troubleshooting.

Webhooks docs Fraud status event reference

GrowSurf emits a dedicated fraud-status webhook event whenever a participant's fraud state changes, which gives your ops team a clean way to trigger review workflows outside the GrowSurf dashboard.

Use this setup when you want high-risk or medium-risk participants to open an internal ticket, trigger a Slack alert, or land in another review system the moment GrowSurf marks them.

Integration Steps

Add your endpoint in GrowSurf and send a test request

GrowSurf Webhooks settings in the Program Editor — Start by connecting the endpoint that should receive fraud review alerts, then use GrowSurf's test request before you automate any downstream actions.

Open the Webhooks card in the Options step, add the endpoint URL that should receive review alerts, and publish your changes. Test the connection before you depend on it for live ops workflows.

Enable `PARTICIPANT_FRAUD_STATUS_UPDATED` and keep the use case narrow

This is the event GrowSurf sends when an existing participant's fraud status changes. According to the docs, it can fire when GrowSurf's anti-fraud system marks someone after suspicious referral activity or when someone is manually marked as a fraudster or non-fraudster from the GrowSurf dashboard.

Route by `fraudRiskLevel` and `fraudReasonCode`

The event payload includes the participant object with both fraudRiskLevel and fraudReasonCode. Use those fields to decide whether the change should create an internal review task, notify support, or simply update an account flag in your own system.

Secure the review endpoint before it can trust the alert

Advanced Webhooks settings showing event selection and secret field — Add a signing secret in the advanced webhook settings so your review queue only accepts webhook calls that actually came from GrowSurf.

Turn on a webhook secret so GrowSurf includes the GrowSurf-Signature header on each request, then verify that signature before you create tickets or mark accounts in your own systems.

Use retries and event logs when the alert pipeline breaks

GrowSurf retries failed webhook deliveries automatically with exponential backoff. If the downstream review tool is unavailable, use GrowSurf's Webhook Event Logs to inspect recent failures while you repair the integration or re-enable a disabled webhook.

Code Snippets

app.post('/growsurf/webhooks', function(req, res) {
  const body = req.body;
  const participant = body.data && body.data.participant;

  if (body.event === 'PARTICIPANT_FRAUD_STATUS_UPDATED' && participant && participant.fraudRiskLevel !== 'LOW') {
    createFraudReviewTask({
      email: participant.email,
      risk: participant.fraudRiskLevel,
      reason: participant.fraudReasonCode
    });
  }

  res.json({ received: true });
});

Tips

Send risky changes to the system your team already watches

The webhook is most useful when it creates an actionable alert in Slack, a ticketing tool, or your internal ops queue instead of quietly writing to a log no one checks.

Inspect the fraud payload before you go live

Point GrowSurf's test request at webhook.site or your own staging endpoint first so you can confirm how your review workflow should read the incoming fraud fields.

FAQ

Which fraud fields are included in the webhook?

The event includes the participant object with fraudRiskLevel and fraudReasonCode, plus the surrounding campaign context.

Does this event fire only for automatic fraud checks?

No. GrowSurf's docs say it can also fire when a participant is manually marked as a fraudster or non-fraudster from the dashboard.

What if the review endpoint fails?

GrowSurf retries failed deliveries automatically for several days, and the current app exposes Webhook Event Logs so you can inspect failing requests while you fix the endpoint.

GrowSurf for Startups Program

Startups get a 50% discount

GrowSurf Deals

Get $234k+ In Software Savings

LoyaltySurf

Reward Your Customers For Their Loyalty

Startup Growth Tactics Quiz

How to Route Fraud Review Alerts with GrowSurf Webhooks

Integration Steps

Add your endpoint in GrowSurf and send a test request

Enable PARTICIPANT_FRAUD_STATUS_UPDATED and keep the use case narrow

Route by fraudRiskLevel and fraudReasonCode

Secure the review endpoint before it can trust the alert

Use retries and event logs when the alert pipeline breaks

Code Snippets

Tips

Send risky changes to the system your team already watches

Inspect the fraud payload before you go live

How to Sync GrowSurf Participant and Referral Events with Webhooks

How to Set Up GrowSurf Referral Notifications in Slack

How to Send Referral Notifications to Slack with Zapier + GrowSurf

FAQ

Which fraud fields are included in the webhook?

Does this event fire only for automatic fraud checks?

What if the review endpoint fails?

Unlock the power of word-of-mouth marketing anddeepen your bond with customers

Set up your refer a friend program with customer referral and affiliate program software that lowers your acquisition costs, increases customer loyalty, and saves you gobs of time.

Built for startups,scaled for unicorns

View GrowSurfCustomer Examples

Enable `PARTICIPANT_FRAUD_STATUS_UPDATED` and keep the use case narrow

Route by `fraudRiskLevel` and `fraudReasonCode`

Unlock the power of word-of-mouth marketing and
deepen your bond with customers

Built for startups,
scaled for unicorns

View GrowSurf
Customer Examples