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.

Code samples

The servers and the test request from this page, ready to copy. Set DC_CANVAS_SECRET to the widget's signing secret first.

Test with curl
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"