API reference / Extend the dashboard
Canvas widgets: Test with curl
Test with curl
Sign a sample request the same way Drop Cowboy® does, then send it to your
server. A valid request returns your Canvas JSON. Change one character of the
body and it should return 401.
SECRET="$DC_CANVAS_SECRET"
BODY='{"event":"canvas.render","widget_id":"3f6c2a1e-8d4b-4c7a-9e2f-5b1d7c3a9e40","slot":"contact_detail","context":{"contact_id":"9d2f7b3a-4e1c-4a8b-b6d5-3c7e0f2a1b84","fields":{"company":"Lopez Roofing"}},"user":{"user_id":"e4a1c8f2-6b3d-4f9e-a7c5-0d2b8e1f4a69","email":null,"name":null},"team_id":"b7e2d9c4-1a6f-4e3b-8c5d-2f9a0e7b6c13","timestamp":"2026-09-30T15:04:05.000Z"}'
TS=$(date +%s)
SIG=$(printf '%s' "$TS.$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -X POST https://crm.example.com/canvas \
-H "content-type: application/json" \
-H "x-timestamp: $TS" \
-H "x-signature: sha256=$SIG" \
-H "x-signature-version: v1" \
-d "$BODY"
For people who set widgets up without writing code, see Canvas.