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

# teamMemberSupportNotificationPreferencesUpdate

> Change which help desk notifications a team member gets, as saving the Notifications tab of their profile does. The preferences belong to the team member, not the store, so a change applies in every store they belong to, as a change on their profile does. An API token can change any team member's, as the store admin who created it can in the help desk. Null when the id isn't a team member of this store. Read the result's `supportNotificationPreferences` with `support_config_read`.

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

## Arguments

**input** `[SupportNotificationPreferencesInput!](/docs/api-reference/v3/reference/support/support-notification-preferences-input)` *required*

**fields**

**playSoundOnDesktop** `Boolean`

Whether a browser notification plays a sound. Left out, or null, keeps it.

**preferences** `[\[SupportNotificationPreferenceInput!\]](/docs/api-reference/v3/reference/support/support-notification-preference-input)`

Changes, each platform and event at most once, or the update fails with BAD\_USER\_INPUT.

**fields**

**desktop** `Boolean`

Notify in the browser while the help desk is open.

**email** `Boolean`

Notify by email.

**event** `[SupportNotificationEvent!](/docs/api-reference/v3/reference/support/support-notification-event)` *required*

The event.

**platform** `[SupportNotificationPlatform!](/docs/api-reference/v3/reference/support/support-notification-platform)` *required*

The kind of conversation.

**push** `Boolean`

Notify on the Redo mobile app.

**teamMemberId** `ID!` *required*

The team member, an `m_us_…` id.

## Returns

**teamMemberSupportNotificationPreferencesUpdate** `[TeamMember](/docs/api-reference/v3/reference/common/team-member)`

A person on the store's team. Shared across areas: support assignees now, and later ticket assignees and other people fields.

**fields**

**email** `String`

Email address. Null when the user has none.

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

m\_us\_… id, the same id the app and MCP tools use.

**name** `String`

Display name. Null when the user hasn't set one.

**supportNotificationPreferences** `[SupportNotificationPreferences](/docs/api-reference/v3/reference/support/support-notification-preferences)`

Which help desk notifications the team member gets: what the help desk's notifier reads for them, with defaults for what they never saved. The same settings as the Notifications tab of their profile. Null when the user can't be read. A request reads its team members 100 at a time, for 10 points each time.

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

**fields**

**playSoundOnDesktop** `Boolean!` *required*

Whether a browser notification plays a sound.

**preferences** `[\[SupportNotificationPreference!\]!](/docs/api-reference/v3/reference/support/support-notification-preference)` *required*

One entry for every platform and event, including ones the team member never changed, which read as their defaults.

**fields**

**desktop** `Boolean!` *required*

Notified in the browser while the help desk is open.

**email** `Boolean!` *required*

Notified by email.

**event** `[SupportNotificationEvent!](/docs/api-reference/v3/reference/support/support-notification-event)` *required*

The event.

**platform** `[SupportNotificationPlatform!](/docs/api-reference/v3/reference/support/support-notification-platform)` *required*

The kind of conversation.

**push** `Boolean!` *required*

Notified on the Redo mobile app.

**supportShiftStatus** `[SupportShiftStatus!](/docs/api-reference/v3/reference/support/support-shift-status)` *required*

The agent's live shift status, worked out when the request runs.

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

**fields**

**manualOverride** `[SupportShiftOverride](/docs/api-reference/v3/reference/support/support-shift-override)`

The agent's manual on/off toggle. Null when they follow their schedule.

**fields**

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

When the override ends and the schedule takes over again. The server sets it.

**onShift** `Boolean!` *required*

True when the agent forced themselves on shift, false when off.

**nextChange** `[SupportShiftChange!](/docs/api-reference/v3/reference/support/support-shift-change)` *required*

The next time the schedule alone flips onShift. Ignores any manual override. Always in the future, or the next local midnight when nothing changes within 14 days.

**fields**

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

When the change happens.

**onShift** `Boolean!` *required*

True when the change starts a shift, false when it ends one.

**onShift** `Boolean!` *required*

True when auto-assignment can give the agent tickets now.

**reason** `[SupportShiftStatusReason!](/docs/api-reference/v3/reference/support/support-shift-status-reason)` *required*

Which layer decided onShift.

**supportWorkSchedule** `[SupportWorkSchedule!](/docs/api-reference/v3/reference/support/support-work-schedule)` *required*

The agent's support working hours. An agent with no saved schedule returns enabled false.

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

**fields**

**assignableChannels** `[\[SupportChannel!\]](/docs/api-reference/v3/reference/support/support-channel)`

Channels the agent takes auto-assigned tickets on. Null means every channel.

**dateOverrides** `[\[SupportWorkScheduleDateOverride!\]!](/docs/api-reference/v3/reference/support/support-work-schedule-date-override)` *required*

Dates whose hours replace that day's weekly hours, earliest first.

**fields**

**available** `Boolean!` *required*

False means the agent is off that whole day.

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

Local date in the schedule's time zone.

**note** `String`

Free-text note, such as "Holiday". Null when none.

**timeBlocks** `[\[TimeBlock!\]!](/docs/api-reference/v3/reference/common/time-block)` *required*

The hours the agent works that date.

**enabled** `Boolean!` *required*

Whether the schedule is on. When false, the agent counts as on shift at all times.

**timeZone** `String!` *required*

IANA time zone the hours are in, such as America/New\_York. The store's time zone when the agent has never saved a schedule.

**weeklyHours** `[\[SupportWorkScheduleDay!\]!](/docs/api-reference/v3/reference/support/support-work-schedule-day)` *required*

Recurring hours. Always seven entries, Monday through Sunday.

**fields**

**day** `[DayOfWeek!](/docs/api-reference/v3/reference/common/day-of-week)` *required*

The day these hours are for.

**enabled** `Boolean!` *required*

False means the agent is off all day.

**timeBlocks** `[\[TimeBlock!\]!](/docs/api-reference/v3/reference/common/time-block)` *required*

The hours the agent works that day.

## 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. |
| `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 {
  teamMemberSupportNotificationPreferencesUpdate(input: { ... }, teamMemberId: "...") {
    email
    id
    name
  }
}
```


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