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.

Request

Method Type: POST

Mandatory fields:

eventType: Type of webhook event. In case of a new update to the investigation, this will be InvestigationUpdated
url: The URL where you want StoneX to send push notifications to.
isActive: Set to either true or false

Example Request

{
  "eventType": "InvestigationUpdated",
  "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": "InvestigationUpdated",
    "url": "https://webhook.site/d1d51d03-9af7-4d9e-9d18-77037831a99999",
    "id": "678f866e853c889d0d449d89",
    "createdDate": "2025-01-21T11:35:10.9736021Z",
    "modifiedDate": "2025-01-21T11:35:10.9736433Z",
    "createdBy": "StoneX Payments",
    "modifiedBy": "StoneX Payments",
    "optimisticVersion": 1
}

Webhook Payload Example

You can find below examples of webhook payloads that you will receive if you are subscribed to the invetsigation webhooks.

When a new Investigation is created either by you or StoneX for one of your existing payments, below payload is sent

{
  "specversion": "v1.0",
  "type": "NewInvestigationCreated",
  "source": "StoneX Payments",
  "id": "e850ab7b-03b4-4c0f-9d9a-bf6780d43b73",
  "datacontenttype": "application/json",
  "time": "2026-08-05T15:13:26.6509172+00:00",
  "data": {
    "clientId": "ABC Corp Ltd",
    "supportTicketId": "CS05011026202107",
    "createdBy": "UATSFL CONNECT",
    "createdDate": "2026-08-05T15:13:25.6377641Z",
    "fxId": null,
    "topic": "Other",
    "reason": "Other",
    "status": "OPEN",
    "orderingInstitutionName": null,
    "instructingInstitution": null,
    "messages": [
      {
        "createdBy": "ABC Corp Ltd",
        "createdDate": "2026-08-05T15:13:25.637Z",
        "comment": "Please cancel the trade",
        "attachments": [],
        "orderingInstitutionName": null,
        "instructingInstitution": null
      }
    ]
  }
}

When an ongoing investigation is commented on or closed, the below sample payload will be sent.

{
  "specversion": "v1.0",
  "type": "InvestigationUpdated",
  "source": "StoneX Payments",
  "id": "e850ab7b-03b4-4c0f-9d9a-bf6780d43b73",
  "datacontenttype": "application/json",
  "time": "2026-08-05T15:13:59.6462779+00:00",
  "data": {
    "clientId": "ABC Corp Ltd",
    "supportTicketId": "CS05082026202107",
    "createdBy": "ABC Corp Ltd",
    "createdDate": "2026-08-05T15:13:25.637Z",
    "fxId": null,
    "topic": "Other",
    "reason": "Other",
    "status": "CLOSED",
    "orderingInstitutionName": null,
    "instructingInstitution": null,
    "messages": [
      {
        "createdBy": "ABC Corp Ltd",
        "createdDate": "2026-08-05T15:13:25.637Z",
        "comment": "Please cancel the trade",
        "attachments": [],
        "orderingInstitutionName": null,
        "instructingInstitution": null
      },
      {
        "createdBy": "StoneX.User",
        "createdDate": "2026-08-05T15:16:58.053Z",
        "comment": "Trade Cancelled & case closed",
        "attachments": [],
        "orderingInstitutionName": null,
        "instructingInstitution": null
      }
    ]
  }
}