Integration Reference

Technical reference for connecting your WMS to Claim Core.

Helm WMS - Setup

1. 1

   Generate API credentials in Helm

   In your Helm WMS admin panel, navigate to API Settings and create a new API key with read access to orders and shipments.

2. 2

   Enter credentials in Claim Core

   Go to Settings → Integrations → Helm WMS. Enter your API key and the base URL for your Helm instance.

3. 3

   Configure the dispatch webhook in Helm

   Copy the webhook URL from Claim Core's integration settings. In Helm, add this URL to your dispatch notification webhooks. Claim Core will receive a POST request each time an order is dispatched.

4. 4

   Test the connection

   Use the Test Connection button in Claim Core to verify credentials. Dispatch a test order in Helm and confirm it appears in the Claim Core integration log.

Webhook payload

Helm sends a JSON payload to the Claim Core webhook endpoint on dispatch. Claim Core expects at minimum an order_reference field. Additional fields are stored and used for evidence display.

{
  "order_reference": "ORD-12345",
  "dispatched_at": "2026-03-15T10:30:00Z",
  "carrier": "DPD",
  "tracking_number": "1Z999AA10123456784"
}

Webhook URL format

The org slug is shown in your integration settings. Each organisation has its own unique webhook URL.

Security

All webhook requests are validated using a shared secret (HMAC-SHA256). The secret is generated automatically and shown once in integration settings. Store it securely in your WMS configuration.