API reference
Provider API reference descriptions are provided in English to preserve the exact published contract.
List Meta Business Portfolios and independently scoped limits List effective provider capabilities by governed scope List provider version, policy, pricing and capability changes Provider Graph API version state per environment Get a WABA with its portfolio, connection and sender state Reconcile WABA subscription and callback override as an Operation Start a fresh Embedded Signup reconnection for a disconnected WABA List Meta Business Portfolios and independently scoped limits GET /v1/accounts/{AC}/portfolios
getV1AccountsByAcPortfoliosPaginated 200
Required scope: `portfolios:read`.
Parameters
Parameters Name Type Required Description limitquery · integer (1–100) cursorquery · string (max 2048 chars) ACpath · string (AC… SID) yes Account SID
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
List effective provider capabilities by governed scope GET /v1/accounts/{AC}/provider-capabilities
getV1AccountsByAcProviderCapabilitiesPaginated 200
Required scope: `provider_changes:read`.
Parameters
Parameters Name Type Required Description limitquery · integer (1–100) cursorquery · string (max 2048 chars) ACpath · string (AC… SID) yes Account SID
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
List provider version, policy, pricing and capability changes GET /v1/accounts/{AC}/provider-changes
getV1AccountsByAcProviderChangesPaginated 200
The change feed: the provider version calendar plus the customer-visible Provider Change Center entries. Several dates are month-only, which datePrecision states rather than implying a day the provider never published.
Required scope: `provider_changes:read`.
Parameters
Parameters Name Type Required Description limitquery · integer (1–100) cursorquery · string (max 2048 chars) ACpath · string (AC… SID) yes Account SID
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
Provider Graph API version state per environment GET /v1/accounts/{AC}/provider-version-calendar
getV1AccountsByAcProviderVersionCalendar200
META-011: for every environment the pinned version, its Meta deprecation date and precision from the calendar, the next non-retired version, and the latest canary with its contract-test evidence. The calendar itself is returned alongside.
Required scope: `provider_changes:read`.
Parameters
Parameters Name Type Required Description ACpath · string (AC… SID) yes Account SID
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
Get a WABA with its portfolio, connection and sender state GET /v1/accounts/{AC}/wabas/{WB}
getV1AccountsByAcWabasByWb200
Required scope: `wabas:read`.
Parameters
Parameters Name Type Required Description ACpath · string (AC… SID) yes Account SID WBpath · string (WB… SID) yes
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
Reconcile WABA subscription and callback override as an Operation POST /v1/accounts/{AC}/wabas/{WB}/reconcile-subscription
postV1AccountsByAcWabasByWbReconcileSubscriptionIdempotency-Key required 202
Required scope: `wabas:write`.
Parameters
Parameters Name Type Required Description ACpath · string (AC… SID) yes Account SID WBpath · string (WB… SID) yes
Request body (2 fields) Request body Name Type Required Description caseRefstring (max 128 chars) yes reasonstring (max 2000 chars) yes
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .
Start a fresh Embedded Signup reconnection for a disconnected WABA POST /v1/accounts/{AC}/wabas/{WB}/reconnect
postV1AccountsByAcWabasByWbReconnectIdempotency-Key required 202
Required scope: `wabas:write`.
Parameters
Parameters Name Type Required Description ACpath · string (AC… SID) yes Account SID WBpath · string (WB… SID) yes
Request body (3 fields) Request body Name Type Required Description caseRefstring (max 128 chars) yes reasonstring (max 2000 chars) yes stepUpTokenstring (max 256 chars) yes
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors .