Skip to main content
POST
Create a new instance

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
instance_type
enum<string>
required
Available options:
waha,
cloud_api
name
string

Optional display name for the instance

phone_number
string

Phone number in international format (e.g., +5511999999999)

Example:

"+5511999999999"

cloud_phone_number_id
string

Cloud API Phone Number ID (from Meta Business)

Example:

"1234567890"

cloud_waba_id
string

Cloud API WhatsApp Business Account ID

Example:

"9876543210"

cloud_access_token
string

Cloud API permanent access token from Meta

Response

Instance created

id
string
required
user_id
string
required
name
string
required
instance_type
enum<string>
required
Available options:
waha,
cloud_api
status
enum<string>
required
Available options:
created,
starting,
scan_qr,
connected,
disconnected,
failed
is_active
boolean
required
created_at
string
required
updated_at
string
required
phone_number
string
display_name
string

WhatsApp display name (pushName)

session_name
string
phone_number_id
string
waba_id
string
access_token
string
webhook_url
string
profile_picture_url
string