---
title: Update user channel settings
full: true
_openapi:
  method: PUT
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          Update a user's settings for a specific channel. Creates the settings
          if they don't exist.


          **Provider-specific settings:**


          **Mobile Push (APNS/FCM):**

          ```json

          {
            "settings": {
              "device_tokens": ["token1", "token2"]
            }
          }

          ```


          **Slack:**

          ```json

          {
            "settings": {
              "slack_channel_id": "C0123456789",
              "slack_user_id": "U0123456789"
            }
          }

          ```

          At least one of `slack_channel_id` or `slack_user_id` must be
          provided.


          **WhatsApp:**

          ```json

          {
            "settings": {
              "phone": "+1234567890"
            }
          }

          ```


          **Telegram:**

          ```json

          {
            "settings": {
              "chat_id": "123456789"
            }
          }

          ```


          **Discord:**

          ```json

          {
            "settings": {
              "discord_channel_id": "1234567890123456789"
            }
          }

          ```
---

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Update a user's settings for a specific channel. Creates the settings if they don't exist.

**Provider-specific settings:**

**Mobile Push (APNS/FCM):**
```json
{
  "settings": {
    "device_tokens": ["token1", "token2"]
  }
}
```

**Slack:**
```json
{
  "settings": {
    "slack_channel_id": "C0123456789",
    "slack_user_id": "U0123456789"
  }
}
```
At least one of `slack_channel_id` or `slack_user_id` must be provided.

**WhatsApp:**
```json
{
  "settings": {
    "phone": "+1234567890"
  }
}
```

**Telegram:**
```json
{
  "settings": {
    "chat_id": "123456789"
  }
}
```

**Discord:**
```json
{
  "settings": {
    "discord_channel_id": "1234567890123456789"
  }
}
```


<APIPage document={"./openapi-admin.json"} operations={[{"path":"/users/{user_external_id}/channel-settings/{channel_id}","method":"put"}]} />