API Status Get API Key
TYPE ⚠️ Experimental

FeatureAuthorizationStatus

Pairs a feature with the channel's authorization status for it (token/scope level). One entry per authorization-gated feature the channel exposes.

Fields 3

feature : Feature!

The feature this status describes — a capability a channel can expose, e.g. posting, commenting, mentions, insights, reacting to engagements (see the Feature enum).

reason : String

Why the feature is in its current status, when a specific cause is known (e.g. the connected platform user lacks rights on the account that owns webhook subscriptions). Informative text for display/support — not a stable machine key, so clients must not parse or switch on it. Null when the status needs no explanation (ok) or no specific cause was identified.

Whether the channel is currently authorized to use feature: ok (usable), needsRefresh (token refresh required), notEnoughData (missing scopes / webhook metadata), needsUpgrade (client below the minimum version — applies only to the mobile apps), or notEnoughRights (the connected platform user's role is insufficient — reconnecting cannot fix it). See the AuthorizationStatus enum.