# Change DM settings

> Replace the DM settings: send all of them (read them with dm.settings first). Call it only when the user asked for this in the conversation; never on your own initiative.

`dm.update_settings` · write

- **MCP tool:** `dm_update_settings`. Catalog: reach it with `find_actions` and `run_write_action`, or turn on the full toolset.
- **REST:** `POST /v1/dm/update-settings`
- **CLI:** `xholic dm update-settings`
- **Scope:** `write`
- **Plan:** Pro plan or higher
- **Cost:** Free.
- **Rate limit bucket:** `write`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `defaults` | object | Yes |  |
| `defaults.deliveryMode` | "AUTOMATIC" \\| "ASSISTED" | No | Default: `"AUTOMATIC"`. |
| `defaults.schedule` | object | No |  |
| `defaults.schedule.timezone` | string ≤ 64 chars | Yes |  |
| `defaults.schedule.sendDays` | integer 1–127 | Yes |  |
| `defaults.schedule.windowStartMinutes` | integer 0–1439 | Yes |  |
| `defaults.schedule.windowEndMinutes` | integer 1–1440 | Yes |  |
| `defaults.schedule.dailyLimit` | integer 1–100 | Yes |  |
| `defaults.schedule.rampStart` | integer 1–100 or null | Yes |  |
| `defaults.schedule.rampStep` | integer 1–50 or null | Yes |  |
| `defaults.schedule.minGapSeconds` | integer 75–3600 | Yes |  |
| `defaults.schedule.maxGapSeconds` | integer 75–3600 | Yes |  |
| `defaults.schedule.startsAt` | string (date-time) or null | Yes |  |
| `defaults.rules` | object | No | Default: `{"recontactAfterDays":null,"excludeCampaignIds":[],"excludeListIds":[],"skipFollowers":false,"skipFollowing":false,"skipExistingConversation":true}`. |
| `defaults.rules.recontactAfterDays` | 30 or 60 or 90 or null | No | Default: `null`. |
| `defaults.rules.excludeCampaignIds` | array of string (uuid) (max 20) | No | Default: `[]`. |
| `defaults.rules.excludeListIds` | array of string (uuid) (max 20) | No | Default: `[]`. |
| `defaults.rules.skipFollowers` | boolean | No | Default: `false`. |
| `defaults.rules.skipFollowing` | boolean | No | Default: `false`. |
| `defaults.rules.skipExistingConversation` | boolean | No | Default: `true`. |
| `assistedDailyLimit` | integer 1–100 | Yes |  |
| `optOutPhrases` | array of string ≤ 40 chars (max 20) | Yes | Replies containing one of these stop all messages to that person. |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |
| `dryRun` | boolean | No | Return exactly what would happen without doing it. |
| `idempotencyKey` | string ≤ 200 chars | No | A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice. |