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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Parameters


ParameterTypeRequiredDescription
partnerIdIntegerYesPartner ID (must match authenticated partner)

Request Body

{
  "enableBSUIDV3": <true/false>,
	"enableBSUID": <true/false>
}

Sample Request

curl -X PUT 'https://partner.gupshup.io/partner/account/apps/config?partnerId={{PARTNER_ID}}' \
  -H 'Authorization: {PARTNER_JWT}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"enableBSUIDV3": true, "enableBSUID": true}'

Response Example

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

Query Params
int32
required

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

Body Params

The configuration you want applied to every linked app. Use the same JSON you would send for a single-app config update — it will be applied to all apps under the partner.

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.

Headers
string
required

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

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json