Contents

API reference

Provider

API reference descriptions are provided in English to preserve the exact published contract.

List Meta Business Portfolios and independently scoped limits

GET /v1/accounts/{AC}/portfolios

Required scope: `portfolios:read`.

Parameters

Parameters
NameTypeRequiredDescription
limitquery · integer (1–100)
cursorquery · string (max 2048 chars)
ACpath · string (AC… SID)yesAccount 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

Required scope: `provider_changes:read`.

Parameters

Parameters
NameTypeRequiredDescription
limitquery · integer (1–100)
cursorquery · string (max 2048 chars)
ACpath · string (AC… SID)yesAccount 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

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
NameTypeRequiredDescription
limitquery · integer (1–100)
cursorquery · string (max 2048 chars)
ACpath · string (AC… SID)yesAccount 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

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
NameTypeRequiredDescription
ACpath · string (AC… SID)yesAccount 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}

Required scope: `wabas:read`.

Parameters

Parameters
NameTypeRequiredDescription
ACpath · string (AC… SID)yesAccount 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

Required scope: `wabas:write`.

Parameters

Parameters
NameTypeRequiredDescription
ACpath · string (AC… SID)yesAccount SID
WBpath · string (WB… SID)yes
Request body (2 fields)
Request body
NameTypeRequiredDescription
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

Required scope: `wabas:write`.

Parameters

Parameters
NameTypeRequiredDescription
ACpath · string (AC… SID)yesAccount SID
WBpath · string (WB… SID)yes
Request body (3 fields)
Request body
NameTypeRequiredDescription
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.