QuickLink

Connect a WhatsApp number with one link.

QuickLink is a hosted, branded page behind a persistent URL. Create it from the Console, your backend, or a Customer record, send it to whoever holds the phone, and get the connected session back. Nothing to embed, no SDK on the page.

Start building Read docs

Two methods

QR on a laptop, a code on the phone.

The hosted page offers a QR code for scanning and a pairing code for phones that cannot scan themselves. It picks the right default for the device that opens it; the recipient can switch at any time.

Acme Inc.

wants to connect a WhatsApp number

Connect WhatsApp

Link a number in about a minute. Nothing is stored on this device.

1.Open WhatsApp on your phone.
2.Go to Settings › Linked devices.
3.Tap Link a device.

Scan a QR codethe standard Linked devices pairing, refreshed automatically

Enter a pairing codetype a phone number, get a one-time code for WhatsApp

Same session either waythe number lands on one REST session with the same webhooks

methods: ['qr', 'pairing']

Three ways to create one

Console, API, or Customer.

Every QuickLink is the same hosted page. Only the place you create it changes.

Console

Open Numbers › New number. Pair right there, or send a QuickLink and watch it move from opened to linked to connected.

API

POST /messaging/quicklinks from your backend with an organization key. You get a URL and a session name, never a browser credential.

Customer

Generate a durable pairing link on a Customer. When the person opens it, Polymorfa issues a fresh QuickLink and assigns the verified number to that Customer.

Return path

Send them, then bring them back.

Add an allowlisted callback URL and the hosted page returns the person to your app with the session name and outcome in the query string. Or skip the redirect and poll the link status from your backend.

your-app.compolymorfa.com/connect/…callbackUrl?session=…&status=connected

Security and consent

The link is the only credential.

A QuickLink carries an opaque token that only works on the hosted pairing routes for one session. It remains active until the number connects or you cancel it. The person sees what they grant before confirming and can unlink from WhatsApp at any time.

No browser credential

The page never receives an API key, project token, or client token. The URL is scoped to pairing and nothing else.

Persistent, one number

Links remain active until use or cancellation and cannot be reused once a number connects. Cancel one from the Console or the API when it is no longer needed.

Plain-language consent

The person reads what your business receives, chooses history sync when you allow it, and confirms. Anyone can report abuse.

Unlink any time

Revocation lives in WhatsApp's own Linked devices menu. The session ends on your side.

Exact-match callbacks

Return URLs are allowlisted per project, exact match only. No wildcards.

Expected-phone locks

Customer pairing links can require one specific number. A mismatch is rejected before ownership is assigned.

How it works

A two-minute job.

Everything between opening the link and a live session is Polymorfa's problem, not yours.

Create the linkFrom the Console, your backend, or a Customer record. Brand it once in settings.

Send it to the phone holderCopy it, share it, or show it as a QR. No account or app install on their side.

The session landsThe number appears under Numbers, your webhooks fire, and the optional callback returns the person to your app.

By the numbers

The whole surface.

Everything a QuickLink does, in one card.

MethodsQR code · pairing code

Created fromConsole · API · Customers

Lifetimeuntil used or cancelled · one number

Brandingname · logo · accent · shape · theme

Returnallowlisted callback URL

Credential on the pagenone

Ship a WhatsApp integration this afternoon.

Free on the sandbox. No credit card. The projects you start here migrate straight into production.

Start building Book a demo