Generate a WhatsApp click-to-chat QR code
Render a QR code that encodes a https://wa.me/<phone>?text=… click-to-chat deep link: scanning it opens a WhatsApp chat with the given number and an optional pre-filled message. The phone number is validated as a dialable international number before encoding. Returns image/png bytes by default, or a base64 data URL in the standard envelope when format=json.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Query Parameters
Destination phone number in international format (e.g. +15551234567). Rejected with 400 when it is not a dialable international number.
1 - 32Optional pre-filled message body for the deep link (max 1024 chars). URL-encoded into the encoded wa.me / sms: payload.
1024Image edge length in pixels (50–1024, default 300). The output PNG is always square.
50 <= x <= 1024png (default) returns raw image/png bytes; json returns the standard envelope with data.qr_data_url as a base64 data URL.
png, json Response
Rendered QR code as PNG image bytes (content-type image/png). Pass format=json to receive a base64 data-URL in the standard { data, meta } envelope instead.
The response is of type file.