Connectors

Truepill

Category: Pharmacy
What it does: Fulfillment webhook adapter for Truepill shipment events. Normalizes Truepill's event payload into Compass shipment records with SLA tracking.

Credentials needed

  • Webhook Secret (required — POSTs without a valid x-compass-signature HMAC are rejected)

Setup

  1. Configure Truepill to POST shipment webhooks to: https://your-domain/api/webhooks/shipping/truepill/<your-tenant-slug>
  2. Add header: x-compass-signature: <hex HMAC-SHA256 of body keyed on Compass webhook secret>
  3. Optionally set a webhook secret and configure it in Compass → PharmacyConnection → webhookSecret

Event shape expected

{
  "eventName": "shipment.in_transit",
  "data": { "externalId": "order-123", "trackingNumber": "1Z...", "carrier": "UPS" },
  "timestamp": "2026-05-15T10:00:00Z"
}