WhatsApp API feature

WhatsApp API QR Code Setup

Link your WhatsApp number to Notivo by scanning a QR code. No complicated onboarding, just a session, a scan and an API key.

Get started Read the API documentation
cURL
# 1. Create a session
curl -X POST https://api.notivo.link/api/sessions \
  -H "x-api-key: YOUR_API_KEY"

# 2. Initialize it, then request the QR code
curl -X POST https://api.notivo.link/api/sessions/SESSION_ID/initialize \
  -H "x-api-key: YOUR_API_KEY"

curl https://api.notivo.link/api/session/qr \
  -H "x-api-key: YOUR_API_KEY"

# 3. After scanning, check the status
curl https://api.notivo.link/api/session/status \
  -H "x-api-key: YOUR_API_KEY"

How does QR code setup work in Notivo?

You create a session, request its QR code and scan it with WhatsApp on your phone from the Linked devices screen. When the session shows as connected, your API key can send messages through that number. You do not scan again for each message.

How do you connect WhatsApp to Notivo?

  1. Create a sessionSign in to the dashboard and create a session. A session represents one WhatsApp number.
  2. Initialize the sessionInitialization prepares the session so a QR code can be generated.
  3. Open the QR codeShow the QR code in the dashboard, or request it from the QR endpoint.
  4. Scan it from your phoneIn WhatsApp, open Linked devices and scan the code with the account you want to connect.
  5. Confirm the statusCheck that the session reports as connected, then send a test message.

What do you get with QR code setup?

Phone-based login

Use the WhatsApp app you already have. There is nothing new to install on the phone.

Dashboard or API

Create sessions and view the QR code in the dashboard, or drive the same steps through API endpoints.

Status endpoint

Check whether a session is connected before your application tries to send.

Reconnect and disconnect

Reconnect a dropped session or disconnect one on purpose using its session endpoints.

What does the session status tell you?

A message can only be sent while the session is connected. The status endpoint returns the state of the session linked to your API key, so your application can check it before sending and handle problems gracefully.

If a session is not connected, request a reconnect. If that is not enough, scan a new QR code. The QR response format and its availability depend on the current session state, and a session may need to be initialized first.

Tips for a smooth setup

  • Scan the code with the WhatsApp account you actually want to connect.
  • Treat a QR code like a password. Anyone who scans it can link that session to their account, so do not share it in public.
  • Send a first test message to your own number before you connect the session to a live system.
  • Keep one session per number, and read how to run several numbers on the multiple sessions page.

When is QR code setup useful?

Small businesses

Connect the number your customers already know and start sending order messages the same day.

Agencies and providers

Connect a number for each client project without a long onboarding process.

Reconnecting

Bring a dropped session back online by rescanning, without rebuilding your integration.

Testing

Link a test number first, then switch to your production number when you are ready.

See how this feature works with the rest of the platform, or browse all Notivo features.

WhatsApp Messaging API

Send messages with one REST endpoint and receive customer replies on your own webhook URL, signed so you can verify each request.

Read about Messaging API

Multiple WhatsApp Sessions

Connect more than one WhatsApp number and manage every session, each with its own API key, from a single dashboard.

Read about Multiple sessions

Secure API Key Management

Authenticate every request with an API key that is linked to one WhatsApp session, and follow simple practices to keep keys private.

Read about API key management

Frequently asked questions: QR Code Setup

How long does QR code setup take?

Most setups take a few minutes: create a session, scan the code and run a test message.

Do I scan the QR code for every message?

No. You scan once to link the session. As long as it stays connected, your API key can send messages without scanning again.

Why is the QR code not showing?

The session may need to be initialized first. Initialize it, then request the QR code again and check the session status.

Can I connect more than one WhatsApp number?

Yes. Each number is its own session. See the multiple sessions feature for details.

Is QR code login the official WhatsApp Business Platform?

No. Notivo links to your WhatsApp account through QR code login and is not affiliated with or endorsed by WhatsApp or Meta.

Start with QR Code Setup

Create your session, scan the QR code and send your first WhatsApp message through the Notivo API.

Get started Read the API documentation