> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SupportInstagramIntegration

> An Instagram business account, which Meta links through a Facebook page.

**Required scopes:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read), [`support_settings_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_settings_write)

**connected** `Boolean!` *required*

Whether the account is connected, as the channels settings page shows it. Gmail, Outlook, custom email, Facebook, Instagram, Attentive, Postscript and TikTok are false until their account is linked, such as an email integration with no mailbox. Every other type is connected while it exists.

**externalReferences** `[\[ExternalReference!\]!](/docs/api-reference/v3/reference/common/external-reference)` *required*

The account on Instagram (provider `instagram`, its business account id), then the Facebook page Meta links it through (provider `facebook`, its page id and name). Redo doesn't store the Instagram username. Empty while the account isn't connected.

**fields**

**externalId** `String!` *required*

The id the provider's current API accepts. For Shopify that is the gid, such as gid://shopify/Product/123.

**name** `String`

The record's display name in that system, when known.

**provider** `String!` *required*

The other system, in lowercase, such as shopify or recharge.

**type** `String`

The kind of record when the provider holds several for one entity, such as product or variant. Null when it holds one.

**facebookPage** `[SupportFacebookIntegration](/docs/api-reference/v3/reference/support/support-facebook-integration)`

The Facebook page integration the account is linked through. Null when that page isn't connected to the help desk.

**fields**

**commentPermissionsGranted** `Boolean!` *required*

Whether the page granted the permissions comment tickets need, pages\_manage\_engagement and pages\_read\_user\_content. False means comments on it won't become tickets until it is reconnected, as the Facebook settings page warns.

**connected** `Boolean!` *required*

Whether the account is connected, as the channels settings page shows it. Gmail, Outlook, custom email, Facebook, Instagram, Attentive, Postscript and TikTok are false until their account is linked, such as an email integration with no mailbox. Every other type is connected while it exists.

**externalReferences** `[\[ExternalReference!\]!](/docs/api-reference/v3/reference/common/external-reference)` *required*

The page on Facebook: provider `facebook`, its page id and its name. Empty while the page isn't connected.

**fields**

**externalId** `String!` *required*

The id the provider's current API accepts. For Shopify that is the gid, such as gid://shopify/Product/123.

**name** `String`

The record's display name in that system, when known.

**provider** `String!` *required*

The other system, in lowercase, such as shopify or recharge.

**type** `String`

The kind of record when the provider holds several for one entity, such as product or variant. Null when it holds one.

**grantedPermissions** `[String!]!` *required*

The Facebook permissions the page granted Redo, such as pages\_messaging. Empty when unknown.

**id** `ID!` *required*

A globally-unique identifier. Treat it as an opaque handle: pass it back to the API (e.g. to `node(id:)`) to refetch this object, but don't parse it or build one yourself — its format is not part of the contract and may change.

**inbound** `[SupportIntegrationInbound!](/docs/api-reference/v3/reference/support/support-integration-inbound)` *required*

How its incoming messages are syncing.

**fields**

**blockedUntil** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When syncing may start again after the provider held it back. Null when it isn't held back.

**failedCount** `Int!` *required*

Incoming messages that failed and won't be retried.

**lastEventAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the last incoming message or event arrived. Null when none has.

**lastPolledAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the help desk last checked for new messages. Null for a channel that pushes them instead.

**latestFailure** `[SupportIntegrationInboundFailure](/docs/api-reference/v3/reference/support/support-integration-inbound-failure)`

The latest failure. Null when none is recorded.

**pendingFailureCount** `Int!` *required*

Incoming messages that failed and are still being retried.

**name** `String`

The inbox's email address for Gmail, Outlook and custom email, the page name for Facebook and Instagram. Null for other types, and while the account isn't connected.

**permissionsRevoked** `Boolean!` *required*

Whether the provider revoked Redo's access, so the integration needs reconnecting.

**profileImageUrl** `String`

The profile picture's URL, when Redo has one from Meta; Meta's links can expire. Connecting an account doesn't save one, so this is null for most accounts, and while the account isn't connected.

**syncError** `String`

The integration's current error, cut to 300 characters and an ellipsis. Null when it has none.

**type** `[SupportIntegrationType!](/docs/api-reference/v3/reference/support/support-integration-type)` *required*

What the integration connects to.

**id** `ID!` *required*

A globally-unique identifier. Treat it as an opaque handle: pass it back to the API (e.g. to `node(id:)`) to refetch this object, but don't parse it or build one yourself — its format is not part of the contract and may change.

**inbound** `[SupportIntegrationInbound!](/docs/api-reference/v3/reference/support/support-integration-inbound)` *required*

How its incoming messages are syncing.

**fields**

**blockedUntil** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When syncing may start again after the provider held it back. Null when it isn't held back.

**failedCount** `Int!` *required*

Incoming messages that failed and won't be retried.

**lastEventAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the last incoming message or event arrived. Null when none has.

**lastPolledAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the help desk last checked for new messages. Null for a channel that pushes them instead.

**latestFailure** `[SupportIntegrationInboundFailure](/docs/api-reference/v3/reference/support/support-integration-inbound-failure)`

The latest failure. Null when none is recorded.

**fields**

**at** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When it failed.

**errorType** `String!` *required*

What kind of failure it was, as the sync recorded it.

**message** `String!` *required*

The failure's message, cut to 300 characters and an ellipsis.

**pendingFailureCount** `Int!` *required*

Incoming messages that failed and are still being retried.

**name** `String`

The inbox's email address for Gmail, Outlook and custom email, the page name for Facebook and Instagram. Null for other types, and while the account isn't connected.

**permissionsRevoked** `Boolean!` *required*

Whether the provider revoked Redo's access, so the integration needs reconnecting.

**profileImageUrl** `String`

The profile picture's URL, when Redo has one from Meta; Meta's links can expire. Connecting an account doesn't save one, so this is null for most accounts, and while the account isn't connected.

**syncError** `String`

The integration's current error, cut to 300 characters and an ellipsis. Null when it has none.

**type** `[SupportIntegrationType!](/docs/api-reference/v3/reference/support/support-integration-type)` *required*

What the integration connects to.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.