Skip to content

Update Account Settings

Tool name: update-account-settings

Updates only named account settings and returns the current state. Inaccessible settings, unknown preview tags, passive-contact tags that are not manual single-value tags of this account, months outside 1-6 or malformed blacklists refuse the whole call before writing. A blacklist change also affects existing contacts, who are skipped when sending once they match. A passive-contact tag is put on matching contacts by a nightly job, which can start automations that tag triggers. Credentials cannot be changed here. The result’s refusals lists settings the platform rejected during save, while other changes may have been stored.

Input schema

settingsobjectrequired

The settings to change, by name; every setting left out keeps its value

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null
Input example
{ "settings": { "enableMetaLabels": true, "enableNotes": true, "enableDdEditorManualSaveButton": true, "disableEmailSignatureSeparator": true, "deactivateUserNotificationEmails": true, "plainTextContentByUser": true, "useEnglishSubscriberArea": true, "deactivateGlobalBounceManagement": true, "unlimitedEmailsPerDay": true, "allowSingleOptInProcess": true, "allowSignaturesWithoutParameters": true, "allowKlicktippSenderAddress": true, "allowEmailRewriting": true, "knownForSpamActivity": true, "previewSubscriberMarkerTag": "string", "emailBlacklist": "string", "passiveContactTag": "string", "passiveContactAfterMonths": 1 }, "accountId": null }

Output schema

accountIdintegerrequired
settingsobjectrequired

The settings this account may edit; one this account may not edit is absent

credentialsobjectrequired

Per service, whether credentials are stored -- never the credentials themselves

editUrlstringrequired
refusalsobject

Rejected preferences from an attempted update; other changes may already be applied in settings

Output example
{ "accountId": 0, "settings": { "property1": true, "property2": true }, "credentials": { "property1": true, "property2": true }, "editUrl": "string", "refusals": { "property1": "string", "property2": "string" } }