Plugin Webhooks
Send and receive webhook events between your service and ThreeU.
Webhook Overview
Webhooks enable real-time event communication. Two directions:
Inbound — Your service sends events to ThreeU
Outbound — ThreeU sends events to your service
Both use signed payloads for authenticity.
Sending Events to ThreeU
POST to the plugin webhook endpoint:
Inbound Webhook Format
HTTP
POST /api/plugins/{id}/webhook
Headers:
Content-Type: application/json
X-Plugin-Signature: sha256=<hmac_hash>
X-Plugin-Timestamp: <unix_timestamp>
X-Brand-ID: <brand_id>
Body:
{
"event": "shipment.delivered",
"data": {
"shipment_id": "shp_abc123"
}
}