--- title: "Update settings" method: PATCH path: "/v3/settings" tags: ["Settings"] --- # Update settings `PATCH /v3/settings` _Requires the `settings:write` scope (or a broader one that includes it)._ Performs a sparse update of settings. Only properties present in the request body are updated — omitted properties are left unchanged. Nested sections follow the same rule: include only the fields you want to change within each section. **Contact stages and account stages** are an exception — when the `contactStages` or `accountStages` array is present, all 8 stages must be provided with unique IDs (1–8). ## Request body - object — Team and user settings. All properties are nullable — on GET, null means the setting is not configured or not applicable. On PATCH, only properties present in the JSON body are updated. - `account` object — User profile settings - `firstName` string, nullable — User's first name - `lastName` string, nullable — User's last name - `company` string, nullable — Company name - `phone` string, nullable — Phone number - `title` string, nullable — Job title - `timezone` string, nullable — IANA timezone identifier (e.g. "America/New_York") - `emails` object — Email-related settings - `isEmailQualityCheckEnabled` boolean, nullable — Whether email quality checks are enabled before sending - `safety` object — Email safety and throttling settings - `firstStepDelay` integer, nullable — Delay in minutes before sending the first step of a sequence - `prospectEmailsPerDayLimit` integer, nullable — Maximum number of emails sent to a single prospect per day - `nonRepliesHandlingType` integer, nullable — How to handle non-replies: 0 = do nothing, 1 = pause, 2 = mark as finished - `inboxNonRepliesHandlingType` integer, nullable — How to handle inbox non-replies: 0 = do nothing, 1 = pause - `inbox` object — Email inbox settings - `bccList` string, nullable — Comma-separated list of BCC email addresses for outgoing emails - `repliesBccList` string, nullable — Comma-separated list of BCC email addresses for replies - `forwardOnlyReplies` boolean, nullable — Whether to forward only replies (not all incoming emails) - `outOfOffice` object — Out-of-office detection and handling settings - `isResumeOutOfOfficeContactsEnabled` boolean, nullable — Whether to automatically resume contacts who return from out-of-office - `isUseSmartReturnDateEnabled` boolean, nullable — Whether to use smart return date detection from out-of-office messages - `defaultDaysToWaitBeforeResumingOutOfOffice` integer, nullable — Default number of days to wait before resuming a contact after out-of-office - `maximumDaysThresholdBeforeResumingOutOfOffice` integer, nullable — Maximum number of days to wait before resuming a contact after out-of-office - `isOpenTrackingDisabled` boolean, nullable — Whether open tracking is disabled for emails - `isAutomaticEmailValidationEnabled` boolean, nullable — Whether automatic email validation is enabled for new contacts - `reassignSequenceProspectsWhenEmailAccountAdded` boolean, nullable — Whether to reassign sequence prospects when a new email account is added - `linkedIn` object — LinkedIn-related settings - `reassignSequenceProspectsWhenLinkedInAccountAdded` boolean, nullable — Whether to reassign sequence prospects when a new LinkedIn account is added - `calls` object — Call-related settings - `isTeamCallsEnabled` boolean, nullable — Whether team cloud calls are enabled. Only the team owner can change this setting. - `resolutions` object[], nullable — List of call resolution options - `id` integer, nullable — Resolution ID. Null when creating a new resolution. - `name` string, required — Display name of the resolution - `defaultResolutionValue` integer, nullable — Default resolution value: 0 = interested, 1 = not interested, 2 = not reached. Required when creating a new resolution (id is null). - `isDefault` boolean — Whether this is the default resolution - `contacts` object — Contact-related settings - `handling` object — Contact handling behavior settings - `pauseProspectOrganizationMode` boolean, nullable — Whether to pause contacts from the same organization when one replies - `pauseProspectOrganizationValue` integer, nullable — Organization pause scope: 1 = same sequence, 2 = all sequences - `pauseProspectInAllCampaignMode` boolean, nullable — Whether to pause a contact in all sequences when they reply in one - `pauseProspectInAllCampaignValue` integer, nullable — All-campaign pause scope: 1 = pause, 2 = mark as finished - `leaveProspectsInSequenceWhenMovingToAnother` boolean, nullable — Whether to keep contacts in the original sequence when moving them to another - `enrichProspectWhenLinkedInUrlIsMissing` boolean, nullable — Whether to attempt LinkedIn URL enrichment when a contact's LinkedIn URL is missing - `contactAccounts` object — Contact account (company) settings - `autoPopulate` boolean, nullable — Whether to automatically populate contact accounts from contact data - `overwriteFields` boolean, nullable — Whether to overwrite existing contact account fields with new data - `contactStages` object[], nullable — Custom contact stage definitions. When updating, all 8 stages must be provided. - `id` integer, required — Stage ID (1–8) - `name` string, required — Display name of the stage - `colorId` integer, nullable — Color identifier for the stage - `description` string, nullable — Description of the stage - `accountStages` object[], nullable — Custom account stage definitions. When updating, all 8 stages must be provided. - `id` integer, required — Stage ID (1–8) - `name` string, required — Display name of the stage - `colorId` integer, nullable — Color identifier for the stage - `beta` object — Beta features settings - `isBetaFeaturesEnabled` boolean, nullable — Whether beta features are enabled for this team. Only the team owner can change this setting. ## Response `200` Settings updated successfully — returns the full settings object after applying changes - object — Team and user settings. All properties are nullable — on GET, null means the setting is not configured or not applicable. On PATCH, only properties present in the JSON body are updated. - `account` object — User profile settings - `firstName` string, nullable — User's first name - `lastName` string, nullable — User's last name - `company` string, nullable — Company name - `phone` string, nullable — Phone number - `title` string, nullable — Job title - `timezone` string, nullable — IANA timezone identifier (e.g. "America/New_York") - `emails` object — Email-related settings - `isEmailQualityCheckEnabled` boolean, nullable — Whether email quality checks are enabled before sending - `safety` object — Email safety and throttling settings - `firstStepDelay` integer, nullable — Delay in minutes before sending the first step of a sequence - `prospectEmailsPerDayLimit` integer, nullable — Maximum number of emails sent to a single prospect per day - `nonRepliesHandlingType` integer, nullable — How to handle non-replies: 0 = do nothing, 1 = pause, 2 = mark as finished - `inboxNonRepliesHandlingType` integer, nullable — How to handle inbox non-replies: 0 = do nothing, 1 = pause - `inbox` object — Email inbox settings - `bccList` string, nullable — Comma-separated list of BCC email addresses for outgoing emails - `repliesBccList` string, nullable — Comma-separated list of BCC email addresses for replies - `forwardOnlyReplies` boolean, nullable — Whether to forward only replies (not all incoming emails) - `outOfOffice` object — Out-of-office detection and handling settings - `isResumeOutOfOfficeContactsEnabled` boolean, nullable — Whether to automatically resume contacts who return from out-of-office - `isUseSmartReturnDateEnabled` boolean, nullable — Whether to use smart return date detection from out-of-office messages - `defaultDaysToWaitBeforeResumingOutOfOffice` integer, nullable — Default number of days to wait before resuming a contact after out-of-office - `maximumDaysThresholdBeforeResumingOutOfOffice` integer, nullable — Maximum number of days to wait before resuming a contact after out-of-office - `isOpenTrackingDisabled` boolean, nullable — Whether open tracking is disabled for emails - `isAutomaticEmailValidationEnabled` boolean, nullable — Whether automatic email validation is enabled for new contacts - `reassignSequenceProspectsWhenEmailAccountAdded` boolean, nullable — Whether to reassign sequence prospects when a new email account is added - `linkedIn` object — LinkedIn-related settings - `reassignSequenceProspectsWhenLinkedInAccountAdded` boolean, nullable — Whether to reassign sequence prospects when a new LinkedIn account is added - `calls` object — Call-related settings - `isTeamCallsEnabled` boolean, nullable — Whether team cloud calls are enabled. Only the team owner can change this setting. - `resolutions` object[], nullable — List of call resolution options - `id` integer, nullable — Resolution ID. Null when creating a new resolution. - `name` string, required — Display name of the resolution - `defaultResolutionValue` integer, nullable — Default resolution value: 0 = interested, 1 = not interested, 2 = not reached. Required when creating a new resolution (id is null). - `isDefault` boolean — Whether this is the default resolution - `contacts` object — Contact-related settings - `handling` object — Contact handling behavior settings - `pauseProspectOrganizationMode` boolean, nullable — Whether to pause contacts from the same organization when one replies - `pauseProspectOrganizationValue` integer, nullable — Organization pause scope: 1 = same sequence, 2 = all sequences - `pauseProspectInAllCampaignMode` boolean, nullable — Whether to pause a contact in all sequences when they reply in one - `pauseProspectInAllCampaignValue` integer, nullable — All-campaign pause scope: 1 = pause, 2 = mark as finished - `leaveProspectsInSequenceWhenMovingToAnother` boolean, nullable — Whether to keep contacts in the original sequence when moving them to another - `enrichProspectWhenLinkedInUrlIsMissing` boolean, nullable — Whether to attempt LinkedIn URL enrichment when a contact's LinkedIn URL is missing - `contactAccounts` object — Contact account (company) settings - `autoPopulate` boolean, nullable — Whether to automatically populate contact accounts from contact data - `overwriteFields` boolean, nullable — Whether to overwrite existing contact account fields with new data - `contactStages` object[], nullable — Custom contact stage definitions. When updating, all 8 stages must be provided. - `id` integer, required — Stage ID (1–8) - `name` string, required — Display name of the stage - `colorId` integer, nullable — Color identifier for the stage - `description` string, nullable — Description of the stage - `accountStages` object[], nullable — Custom account stage definitions. When updating, all 8 stages must be provided. - `id` integer, required — Stage ID (1–8) - `name` string, required — Display name of the stage - `colorId` integer, nullable — Color identifier for the stage - `beta` object — Beta features settings - `isBetaFeaturesEnabled` boolean, nullable — Whether beta features are enabled for this team. Only the team owner can change this setting. ## Other responses - `400` — Validation failure on the request body, or a business rule rejection (e.g. a sparse-update rule that requires all 8 contact stages when `contactStages` is present). - `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme. - `403` — Non-owner user tried to change an owner-only field - `404` — User or team settings not found - `429` — Too Many Requests --- [API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)