Investigation Webhooks

You must subscribe to webhooks for StoneX to provide you push notifications regarding any investigations on your account.

These webhooks allow you to view any new investigation created and updated including when StoneX team has created the investigation.

There are currently 2 event types supported.

NewInvestigationCreated
InvestigationUpdated

Request

Use the Create Webhook endpoint to setup the new webhook connection.

Method Type: POST

Mandatory fields:

eventType: Type of webhook event. In case of creation of new investigation, this will be NewInvestigationCreated You can use this to receive notification of new investigation created.
url: The URL where you want StoneX to send push notifications to.
isActive: Set to either true or false

Example Request

{
  "eventType": "NewInvestigationCreated",
  "url": "https://webhook.site/d1d51d03-9af7-4d9e-9d18-77037831a99999",
  "isActive": true
}

Response

A successful response with a HTTP 201 status confirms the creation of the new webhook connection.

Http Status: 201 Created

Example Response

{
    "clientId": "TEST CLIENT",
    "isActive": true,
    "webhookEventType": "NewInvestigationCreated",
    "url": "https://webhook.site/d1d51d03-9af7-4d9e-9d18-77037831a99999",
    "id": "678f866e853c889d0d449d88",
    "createdDate": "2025-01-21T11:35:10.9736021Z",
    "modifiedDate": "2025-01-21T11:35:10.9736433Z",
    "createdBy": "StoneX Payments",
    "modifiedBy": "StoneX Payments",
    "optimisticVersion": 1
}

Similarly, in case of any updates to the existing investigation, can be notified via InvestigationUpdated event. This will allow you to receive notification for any updates including status change, file uploads and comments added by StoneX team.