Business Username

Endpoints for managing WhatsApp business username

Get current business username

get

Retrieve current WhatsApp business username and status.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

Username retrieved successfully

application/json

Response payload for retrieving current business username

statusstringOptionalExample: approved

usernamestringOptionalExample: my_business

401

Unauthorized

application/json

500

Internal server error

application/json

get/username

HTTPcURLJavaScriptPython

GET /username HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "status": "approved",
  "username": "my_business"
}

Adopt or change business username

post

Adopt or change WhatsApp business username. On success, username status is either approved (visible to WhatsApp users after feature rollout) or reserved (approved but not yet visible).

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

Adopt username request payload

usernamestringOptionalExample: my_business

Responses

200

Username adopted or changed successfully

application/json

Response payload for successful business username adoption or change

statusstringOptionalExample: approved

400

Meta API error with operation-specific code and details

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post/username

HTTPcURLJavaScriptPython

POST /username HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "username": "my_business"
}

{
  "status": "approved"
}

Delete business username

delete

Delete WhatsApp business username.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

Username deleted successfully

application/json

Response payload for deleting business username

successbooleanOptionalExample: true

401

Unauthorized

application/json

500

Internal server error

application/json

delete/username

HTTPcURLJavaScriptPython

DELETE /username HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "success": true
}

Get reserved business username suggestions

get

Get reserved WhatsApp business username suggestions. Reserved usernames have higher approval likelihood.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Responses

200

Reserved username suggestions retrieved successfully

application/json

Response payload for retrieving reserved business username suggestions

401

Unauthorized

application/json

500

Internal server error

application/json

get/username_suggestions

HTTPcURLJavaScriptPython

GET /username_suggestions HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "username_suggestions": [
        "my_business_1",
        "my_business_2"
      ]
    }
  ]
}