Skip to main content
PUT
/
v1
/
organization
/
whatsapp
/
phone-numbers
/
{phoneNumberId}
/
apps
cURL
curl --request PUT \
  --url https://api.buildwithchirp.com/v1/organization/whatsapp/phone-numbers/{phoneNumberId}/apps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "appIds": [
    "app_2DbBs7GWhGvVNJGrDXr5RG0mBWI"
  ]
}
'
{
  "id": "wapn_2DbBs7GWhGvVNJGrDXr5RG0mBWI",
  "displayPhoneNumber": "<string>",
  "metaPhoneNumberId": "<string>",
  "metaBusinessAccountId": "<string>",
  "verified": true,
  "qualityRating": "<string>",
  "throughputTier": "<string>",
  "qualityEvent": "<string>",
  "qualityEventAt": "2023-11-07T05:31:56Z",
  "nameStatus": "<string>",
  "requestedVerifiedName": "<string>",
  "nameRejectionReason": "<string>",
  "nameDecisionAt": "2023-11-07T05:31:56Z",
  "isTestNumber": true,
  "cloudApiRegistered": true,
  "businessProfile": {
    "id": "<string>",
    "metaWabaId": "<string>",
    "businessName": "<string>"
  },
  "apps": [
    {
      "appId": "<string>",
      "appName": "<string>",
      "appSlug": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Path Parameters

​
phoneNumberId
string
required

Unique identifier for a WhatsApp Phone Number. Format: wapn_[test_]{ksuid}

Pattern: ^wapn_(?:test_)?[a-zA-Z0-9]{27}$
Example:

"wapn_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

Body

application/json
​
appIds
string[]
required

Array of app IDs to assign the phone number to

Example:
["app_2DbBs7GWhGvVNJGrDXr5RG0mBWI"]

Response

WhatsApp phone number app assignments updated successfully

​
id
string
required

Unique identifier for a WhatsApp Phone Number. Format: wapn_[test_]{ksuid}

Pattern: ^wapn_(?:test_)?[a-zA-Z0-9]{27}$
Example:

"wapn_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

​
displayPhoneNumber
string
required
​
metaPhoneNumberId
string
required
​
metaBusinessAccountId
string
required
​
verified
boolean
required
​
qualityRating
string | null
required
​
throughputTier
string | null
required

Messaging throughput tier from phone_number_quality_update (e.g. STANDARD, HIGH)

​
qualityEvent
string | null
required

Most recent quality event (e.g. FLAGGED, ONBOARDED, UPGRADE)

​
qualityEventAt
string<date-time> | null
required
​
nameStatus
string | null
required

Display name verification status (APPROVED, REJECTED, PENDING, DEFERRED)

​
requestedVerifiedName
string | null
required
​
nameRejectionReason
string | null
required
​
nameDecisionAt
string<date-time> | null
required
​
isTestNumber
boolean
required
​
cloudApiRegistered
boolean
required

Whether the phone number has been registered with Meta Cloud API (two-step verification)

​
businessProfile
object | null
required

The WhatsApp Business Account (WABA) this phone number belongs to

​
apps
object[]
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required