---
title: "Get channel settings"
method: GET
path: "/settings"
tags: ["Channel"]
---

# Get channel settings

`GET /settings`

## Request body

- object

## Response `200`

OK

- Settings
  - `pdo_sync` boolean — It is recommended to disable it for iOS.
  - `callback_backoff_delay_ms` number — Backoff delay for a failed callback in milliseconds This setting is used to configure the amount of time the backoff delays before retrying a failed callback. The backoff delay increases linearly by this value each time a callback fails to get a HTTPS 200 OK response. The backoff delay is capped by the max_callback_backoff_delay_ms setting.
  - `max_callback_backoff_delay_ms` number — Maximum delay for a failed callback in milliseconds
  - `callback_persist` boolean — Stores callbacks on disk until they are successfully acknowledged by the Webhook or not. Restart required.
  - `media` MediaSettings
    - `auto_download` string[] — An array specifying which types of media to automatically download.
    - `init_avatars` boolean — Set to true if you need to get avatars after channel authorization
  - `webhooks` Webhook[]
    - `send_undecrypted_ad` boolean — Send a webhook for an ad that could not be decrypted.
    - `webhook_max_age_seconds` number, nullable — Time in seconds. If the message is delayed more than this time, the hook will not be sent.
    - `headers` object — Additional headers for webhook. Max 5 headers. <br/>Example: <br/>"Authorization - Bearer token" <br/>"Content-Type - application/json" <br/>"X-Header - value"
    - `url` string, required — Inbound and outbound notifications are routed to this URL.
    - `mode` 'body' | 'path' | 'method' — Request method for sending hook.
    - `events` Event[] — Tracked events. <br/>"messages" - got new message/got offline messages/edit message/delete message;<br/>"statuses" - got message status/got offline message status;<br/>"chats" - got chat/chat update/chat remove;<br/>"contacts" - contact update;<br/>"presences" - got presences<br/>"groups" - new group/participants update/group update;<br/>"calls" - got call events<br/>labels" - new label/remove label<br/>"users" - login user/logout user<br/>"channel" - instance status changed/QR-code update<br/>"service" - special notifications<br/><br/>"message", "ack", "chat", "status" - is deprecated, use "messages", "statuses", "chats", "channel" instead.
      - `type` 'messages' | 'statuses' | 'chats' | 'contacts' | 'groups' | 'presences' | 'calls' | 'channel' | 'users' | 'labels' | 'service'
      - `method` 'post' | 'put' | 'delete' | 'patch'
  - `proxy` string — Use your Socks5 proxy if your account activity arouses suspicion from WhatsApp. This can help maintain anonymity and ensure smooth operation.
  - `mobile_proxy` string — Service proxy for mobile authorization. Beta-only parameter; ignored in the production version.
  - `offline_mode` boolean — When true, API will not send online status to the server on connection. This will allow you to receive push notifications to devices connected to the number. Working after reconnect.
  - `full_history` boolean — When true, all messages will be cached after the connection. If false, old messages will selectively not be cached, allowing large accounts to run faster. Working after reconnect.
  - `auto_read_messages` boolean — When enabled, all incoming messages are automatically marked as read as soon as they are received by the API channel. You do not need to mark each message as read manually through the API.
  - `mock_pairing_code` string — Fixed 8-character pairing code for link-code authorization. When omitted or empty, a random code is generated for every request.
  - `ignored_presences` ChatID[] — List of presences to ignore.
  - `data_mode` 'original' | 'replace' | 'extend' — Data presentation mode

## Other responses

- `500` — Internal Error

---

[API](https://skmtc.dev/whapi/apis/whatsapp-api.md) · [All operations](https://skmtc.dev/whapi/apis/whatsapp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whapi/whatsapp-api/revisions/40ab05abffdb/schema)