Sign in
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)

Warning: connecting subscribes your own Meta app to this WABA with an override callback that redirects its webhook delivery to Zernio. This WABA's events stop reaching any callback URL you had configured before, immediately and with no overlap window. Do not unsubscribe your app from the WABA afterward: that also cuts off Zernio's delivery, and recovery requires calling this endpoint again.

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.

webhookNoticestring

Present when the WABA webhook subscription (with the Zernio override callback) succeeded. Explains the delivery cutover and warns against unsubscribing the app from the WABA afterward.