Update Self-recovery Config
curl --request PATCH \
--url https://api.lemlist.com/api/self-recovery/config \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"monitoredSignals": [
"bounceRate",
"blacklist"
],
"authorizedActions": [
"recover"
],
"digestFrequency": "weekly"
}
'import requests
url = "https://api.lemlist.com/api/self-recovery/config"
payload = {
"monitoredSignals": ["bounceRate", "blacklist"],
"authorizedActions": ["recover"],
"digestFrequency": "weekly"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
monitoredSignals: ['bounceRate', 'blacklist'],
authorizedActions: ['recover'],
digestFrequency: 'weekly'
})
};
fetch('https://api.lemlist.com/api/self-recovery/config', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/self-recovery/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"monitoredSignals\": [\n \"bounceRate\",\n \"blacklist\"\n ],\n \"authorizedActions\": [\n \"recover\"\n ],\n \"digestFrequency\": \"weekly\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/self-recovery/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'monitoredSignals' => [
'bounceRate',
'blacklist'
],
'authorizedActions' => [
'recover'
],
'digestFrequency' => 'weekly'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"config": {
"_id": "src_ExampleAcmeConfigId",
"teamId": "tea_ExampleAcmeTeamId",
"enabled": true,
"monitoredSignals": [
"bounceRate",
"blacklist"
],
"authorizedActions": [
"recover"
],
"digestFrequency": "weekly",
"createdBy": "usr_ExampleAcmeUserId",
"createdAt": "2026-04-12T09:30:00.000Z",
"updatedAt": "2026-05-06T14:10:00.000Z"
}
}Self-recovery
Update Self-recovery Config
Updates your team’s self-recovery configuration. Every field is optional; only the fields you send are changed.
PATCH
/
self-recovery
/
config
Update Self-recovery Config
curl --request PATCH \
--url https://api.lemlist.com/api/self-recovery/config \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"monitoredSignals": [
"bounceRate",
"blacklist"
],
"authorizedActions": [
"recover"
],
"digestFrequency": "weekly"
}
'import requests
url = "https://api.lemlist.com/api/self-recovery/config"
payload = {
"monitoredSignals": ["bounceRate", "blacklist"],
"authorizedActions": ["recover"],
"digestFrequency": "weekly"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
monitoredSignals: ['bounceRate', 'blacklist'],
authorizedActions: ['recover'],
digestFrequency: 'weekly'
})
};
fetch('https://api.lemlist.com/api/self-recovery/config', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/self-recovery/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"monitoredSignals\": [\n \"bounceRate\",\n \"blacklist\"\n ],\n \"authorizedActions\": [\n \"recover\"\n ],\n \"digestFrequency\": \"weekly\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/self-recovery/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'monitoredSignals' => [
'bounceRate',
'blacklist'
],
'authorizedActions' => [
'recover'
],
'digestFrequency' => 'weekly'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"config": {
"_id": "src_ExampleAcmeConfigId",
"teamId": "tea_ExampleAcmeTeamId",
"enabled": true,
"monitoredSignals": [
"bounceRate",
"blacklist"
],
"authorizedActions": [
"recover"
],
"digestFrequency": "weekly",
"createdBy": "usr_ExampleAcmeUserId",
"createdAt": "2026-04-12T09:30:00.000Z",
"updatedAt": "2026-05-06T14:10:00.000Z"
}
}What you can change
enabled— turn self-recovery on or off for the account.monitoredSignals— the signals self-recovery watches. This replaces the current list, so send the full set, not a delta.inboxPlacementrequires the inbox-placement test to be active on the account.authorizedActions— the strategies self-recovery may run automatically. This replaces the current list.digestFrequency— how often team admins get the recovery summary email:daily, orweeklyon Mondays. It is sent at 8am in the team timezone, and only when self-recovery opened a case.
digestFrequency starts at daily unless you send it.
Authorized actions
OnlyfixDns and recover can be authorized:
fixDns— pause sending until the DNS records are corrected.recover— cap the daily sending volume and re-warm the mailbox.
provision, replace and listHygiene are diagnosis-only: self-recovery will still recommend them in the history, but it never executes them automatically. Sending any of them in authorizedActions returns 400.Authorizations
Body
application/json
All fields are optional; only the supplied fields change. monitoredSignals and authorizedActions replace the current lists (send the full set). Only fixDns and recover may be authorized. The first update creates the configuration, with digestFrequency set to daily unless you send it.
Was this page helpful?