Skip to main content
Whether you use hosted or custom UI, the user eventually comes back to your redirectUrl with query parameters.

Success Callbacks


Error Callbacks

Handle not-enough-permissions gracefully. Tell the user the permissions are required for publishing, then let them reconnect.

Error Reasons (Facebook And Instagram)

When a Facebook or Instagram (through Facebook) connection finds no Page to publish to, the error stays facebook-not-enough-pages or instagram-not-enough-accounts, and an extra errorReason parameter says why. It’s optional, so fall back to the error message when it’s missing.
Pages that Meta lists without a Page token are no longer offered for selection, because publishing to them would fail later. They count as facebook-page-token-withheld. Refresh channels: if refreshing a Facebook account’s channels finds no usable Page, the call returns 400 with the matching message above and keeps the stored channels, instead of saving an empty list.