v1

latestOpenAPI 3.0.32026-07-268345159.5 KB
Partner

Bulk Update App Configuration

Use this API when you need to roll out the same setting across all WhatsApp apps under your partner account — for example, enabling a feature flag for every linked app.

How it works

  1. Submit the configuration you want applied, along with your Partner ID.
  2. You receive instant confirmation and the total number of apps queued.
  3. Updates run in the background — you do not need to wait on the API call.
  4. The partner admin receives an email when processing completes.

Important: There is no job tracking ID. The completion email is how you know the update has finished.

Email outcomes

  • All apps succeed → success email with summary counts; no attachment.
  • Some apps fail → email with summary plus a CSV listing failed app IDs and error reasons.

Access: Partner Admin or Partner User. Partner ID must match your logged-in account. Rate limit: 1 requests per 60 seconds.

put/partner/account/apps/config

Query parameters

partnerIdinteger required

Your Partner ID. Must match the partner account you are logged in as.

Headers

Authorizationstring required

Your partner token, please refer partner token api to get the token from partner documentation.

Request body

AppConfigUpdateRequest required

Configuration settings to apply to each linked app (for example, enabling or disabling a feature). The exact fields depend on the setting you are updating.

Example request

{
  "enableBSUIDV3": true
}

Response

Your bulk update has been queued successfully. You can continue other work — the partner admin will receive an email with the final results when all apps have been processed.

statusstring required

Indicates the bulk update was successfully queued

messagestring required

Confirmation message — processing continues in the background and the partner admin will be emailed when complete

partnerIdstring required

The partner account this bulk update applies to

totalAppsstring required

How many apps were queued for update — check the partner admin email for final success/failure counts

Example response

{
  "status": "success",
  "message": "App config update queued for partner 48xx A summary will be emailed to the partner admin when processing completes.",
  "partnerId": "48xx",
  "totalApps": "221"
}