> ## 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.

# supportIntegrationUpdate

> Change an integration's settings, as the email settings page's edit modals and the Voice & SMS settings page do. Saving voice settings makes no call to the phone provider. Returns the integration after the change; null when no integration of the store has this id.

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

## Arguments

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

The `id` of the integration to change.

**input** `[SupportIntegrationUpdateInput!](/docs/api-reference/v3/reference/support/support-integration-update-input)` *required*

The changes.

**fields**

**email** `[SupportEmailIntegrationUpdateInput](/docs/api-reference/v3/reference/support/support-email-integration-update-input)`

For Gmail, Outlook and custom email only; BAD\_USER\_INPUT on any other type.

**fields**

**senderName** `String`

The From name replies go out with. 1 to 255 characters after surrounding spaces are trimmed; otherwise BAD\_USER\_INPUT. A custom email on Postmark renames its Postmark sender too. Can't be cleared.

**voice** `[SupportVoiceSettingsInput](/docs/api-reference/v3/reference/support/support-voice-settings-input)`

For the voice integration only; BAD\_USER\_INPUT on any other type.

**fields**

**allowHoldingCallsInQueue** `Boolean`

Can't be cleared.

**enabled** `Boolean`

Turning it off hangs up calls from numbers other than the test numbers right away. Can't be cleared.

**holdMusic** `[SupportVoiceAudioInput](/docs/api-reference/v3/reference/support/support-voice-audio-input)`

Null goes back to Redo's default music.

**hours** `[SupportVoiceHoursInput](/docs/api-reference/v3/reference/support/support-voice-hours-input)`

Can't be cleared.

**inboundGreeting** `[SupportVoiceMessageInput](/docs/api-reference/v3/reference/support/support-voice-message-input)`

Can't be cleared.

**offHoursMessage** `[SupportVoiceMessageInput](/docs/api-reference/v3/reference/support/support-voice-message-input)`

Can't be cleared.

**outboundGreeting** `[SupportVoiceMessageInput](/docs/api-reference/v3/reference/support/support-voice-message-input)`

Can't be cleared.

**playAutomatedMessageWhenAllOffline** `Boolean`

Can't be cleared.

**ringingStrategy** `[SupportVoiceRingingStrategy](/docs/api-reference/v3/reference/support/support-voice-ringing-strategy)`

Can't be cleared.

**sendToVoicemailWhenAllOffline** `Boolean`

Can't be cleared.

**testPhoneNumbers** `[String!]`

Replaces the list of at most 50 numbers. Each in E.164, such as +15555550100; otherwise BAD\_USER\_INPUT.

**voicemailMessage** `[SupportVoiceMessageInput](/docs/api-reference/v3/reference/support/support-voice-message-input)`

Can't be cleared.

## Returns

**supportIntegrationUpdate** `[SupportIntegration](/docs/api-reference/v3/reference/support/support-integration)`

One account the help desk is connected to, such as an inbox, a Facebook page or a phone number, and how it is syncing, as the channels settings page shows it. `node(id:)` reaches any of the store's integrations, also one past the 100 `supportIntegrations` lists.

**fields**

**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.

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

The id of this integration.

**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.

**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.

**Possible types:** [`SupportCustomEmailIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-custom-email-integration), [`SupportFacebookIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-facebook-integration), [`SupportGmailIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-gmail-integration), [`SupportInstagramIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-instagram-integration), [`SupportOutlookIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-outlook-integration), [`SupportSmsIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-sms-integration), [`SupportStandardIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-standard-integration), [`SupportVoiceIntegration`](https://developers.redo.com/docs/api-reference/v3/reference/support/support-voice-integration)

## Errors

Besides the [errors any request can return](https://developers.redo.com/docs/api-reference/v3/errors.md), this operation fails with these codes in `extensions.code`.

| Code | HTTP status | Meaning | Retry |
| - | - | - | - |
| `API_TOKEN_REQUIRED` | `403` | The credential has no API token to attribute the change to, such as a first-party token. Nothing was sent. | Call with a store API token. |
| `BAD_USER_INPUT` | `400` | An argument is invalid, or names something the store doesn't have. The message says which. Nothing was written. | Fix the input the message names, then send it again. |
| `TRY_AGAIN` | `503` | The change couldn't start for a passing reason, and nothing was written or sent. | Send the same request again after a short wait, with the same idempotencyKey if it has one. |
| `INTERNAL_SERVER_ERROR` | `500` | Something failed on Redo's side. The change may or may not have been made. | Read the record to see whether the change was made before sending it again. A send with an idempotencyKey is safe to retry with the same key. |

## Example

```graphql theme={null}
mutation {
  supportIntegrationUpdate(id: "...", input: { ... }) {
    connected
    id
    name
    permissionsRevoked
    syncError
    type
  }
}
```


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