v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Connect

Connect WhatsApp via credentials

Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.

To get the required credentials:

  1. Go to Meta Business Suite (business.facebook.com)
  2. Create or select a WhatsApp Business Account
  3. In Business Settings > System Users, create a System User
  4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions
  5. Generate a permanent access token
  6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers
  7. Get the Phone Number ID from the same page (click on the number)
post/v1/connect/whatsapp/credentials

Request body

profileIdstring required

Your Zernio profile ID

accessTokenstring required

Permanent System User access token from Meta Business Suite

wabaIdstring required

WhatsApp Business Account ID from Meta

phoneNumberIdstring required

Phone Number ID from Meta WhatsApp Manager

pinstring

The 6-digit two-step verification PIN set on the number. Required if you enabled two-step verification for it, otherwise Meta rejects the Cloud API registration with error 133005 and the number cannot send messages.

Response

WhatsApp connected successfully

messagestring
registrationWarningstring

Present when the account was created but Meta rejected the Cloud API registration. The number cannot send messages until this is resolved.