Update Campaign
curl --request PATCH \
--url https://api.goextrovert.com/client/v2/campaign/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skipTeammatesLeads": true,
"outreach": {
"warmUp": {
"enabled": true,
"direct": {
"enabled": true,
"commentTarget": 123
},
"indirect": {
"enabled": true,
"commentTarget": 123
},
"skipWarmUpWhenNoRecentPosts": true,
"stopWaiting": {
"enabled": true,
"afterDays": 123
}
},
"connectionRequests": {
"enabled": true
},
"directMessages": {
"enabled": true,
"firstOutreach": {
"enabled": true,
"waitAfterAcceptance": {
"enabled": true,
"days": 4503599627370496
}
},
"followUps": {
"enabled": true,
"limit": {
"isUnlimited": true,
"maxFollowUps": 0
},
"cadenceDays": [
4503599627370496
],
"tailCadenceDays": 4503599627370496,
"relevantPostAcceleration": {
"enabled": true
}
}
}
}
}
'import requests
url = "https://api.goextrovert.com/client/v2/campaign/{id}"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skipTeammatesLeads": True,
"outreach": {
"warmUp": {
"enabled": True,
"direct": {
"enabled": True,
"commentTarget": 123
},
"indirect": {
"enabled": True,
"commentTarget": 123
},
"skipWarmUpWhenNoRecentPosts": True,
"stopWaiting": {
"enabled": True,
"afterDays": 123
}
},
"connectionRequests": { "enabled": True },
"directMessages": {
"enabled": True,
"firstOutreach": {
"enabled": True,
"waitAfterAcceptance": {
"enabled": True,
"days": 4503599627370496
}
},
"followUps": {
"enabled": True,
"limit": {
"isUnlimited": True,
"maxFollowUps": 0
},
"cadenceDays": [4503599627370496],
"tailCadenceDays": 4503599627370496,
"relevantPostAcceleration": { "enabled": True }
}
}
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
voiceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
skipTeammatesLeads: true,
outreach: {
warmUp: {
enabled: true,
direct: {enabled: true, commentTarget: 123},
indirect: {enabled: true, commentTarget: 123},
skipWarmUpWhenNoRecentPosts: true,
stopWaiting: {enabled: true, afterDays: 123}
},
connectionRequests: {enabled: true},
directMessages: {
enabled: true,
firstOutreach: {enabled: true, waitAfterAcceptance: {enabled: true, days: 4503599627370496}},
followUps: {
enabled: true,
limit: {isUnlimited: true, maxFollowUps: 0},
cadenceDays: [4503599627370496],
tailCadenceDays: 4503599627370496,
relevantPostAcceleration: {enabled: true}
}
}
}
})
};
fetch('https://api.goextrovert.com/client/v2/campaign/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.goextrovert.com/client/v2/campaign/{id}",
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([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'voiceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'skipTeammatesLeads' => true,
'outreach' => [
'warmUp' => [
'enabled' => true,
'direct' => [
'enabled' => true,
'commentTarget' => 123
],
'indirect' => [
'enabled' => true,
'commentTarget' => 123
],
'skipWarmUpWhenNoRecentPosts' => true,
'stopWaiting' => [
'enabled' => true,
'afterDays' => 123
]
],
'connectionRequests' => [
'enabled' => true
],
'directMessages' => [
'enabled' => true,
'firstOutreach' => [
'enabled' => true,
'waitAfterAcceptance' => [
'enabled' => true,
'days' => 4503599627370496
]
],
'followUps' => [
'enabled' => true,
'limit' => [
'isUnlimited' => true,
'maxFollowUps' => 0
],
'cadenceDays' => [
4503599627370496
],
'tailCadenceDays' => 4503599627370496,
'relevantPostAcceleration' => [
'enabled' => true
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.goextrovert.com/client/v2/campaign/{id}"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.goextrovert.com/client/v2/campaign/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.goextrovert.com/client/v2/campaign/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": null,
"message": "Operation completed successfully"
}{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}Campaigns
Update Campaign
Updates the editable fields of an existing campaign. id, name, voiceId and skipTeammatesLeads are required (full replace). Backend types TARGET_USER and KEYWORD correspond to user-facing ‘Prospects campaign’ and ‘Topic campaign’ respectively.
KEYWORD campaigns: only name and the comment policy are editable. The backend rejects with a 409 state-conflict whenever skipTeammatesLeads, an explicitly passed outreach.connectionRequests.enabled, or an explicitly passed outreach.directMessages.enabled differs from the current value. Omitting the optional outreach and commenting objects means “no change” and is always safe.
PATCH
/
client
/
v2
/
campaign
/
{id}
Update Campaign
curl --request PATCH \
--url https://api.goextrovert.com/client/v2/campaign/{id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skipTeammatesLeads": true,
"outreach": {
"warmUp": {
"enabled": true,
"direct": {
"enabled": true,
"commentTarget": 123
},
"indirect": {
"enabled": true,
"commentTarget": 123
},
"skipWarmUpWhenNoRecentPosts": true,
"stopWaiting": {
"enabled": true,
"afterDays": 123
}
},
"connectionRequests": {
"enabled": true
},
"directMessages": {
"enabled": true,
"firstOutreach": {
"enabled": true,
"waitAfterAcceptance": {
"enabled": true,
"days": 4503599627370496
}
},
"followUps": {
"enabled": true,
"limit": {
"isUnlimited": true,
"maxFollowUps": 0
},
"cadenceDays": [
4503599627370496
],
"tailCadenceDays": 4503599627370496,
"relevantPostAcceleration": {
"enabled": true
}
}
}
}
}
'import requests
url = "https://api.goextrovert.com/client/v2/campaign/{id}"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"voiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"skipTeammatesLeads": True,
"outreach": {
"warmUp": {
"enabled": True,
"direct": {
"enabled": True,
"commentTarget": 123
},
"indirect": {
"enabled": True,
"commentTarget": 123
},
"skipWarmUpWhenNoRecentPosts": True,
"stopWaiting": {
"enabled": True,
"afterDays": 123
}
},
"connectionRequests": { "enabled": True },
"directMessages": {
"enabled": True,
"firstOutreach": {
"enabled": True,
"waitAfterAcceptance": {
"enabled": True,
"days": 4503599627370496
}
},
"followUps": {
"enabled": True,
"limit": {
"isUnlimited": True,
"maxFollowUps": 0
},
"cadenceDays": [4503599627370496],
"tailCadenceDays": 4503599627370496,
"relevantPostAcceleration": { "enabled": True }
}
}
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
voiceId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
skipTeammatesLeads: true,
outreach: {
warmUp: {
enabled: true,
direct: {enabled: true, commentTarget: 123},
indirect: {enabled: true, commentTarget: 123},
skipWarmUpWhenNoRecentPosts: true,
stopWaiting: {enabled: true, afterDays: 123}
},
connectionRequests: {enabled: true},
directMessages: {
enabled: true,
firstOutreach: {enabled: true, waitAfterAcceptance: {enabled: true, days: 4503599627370496}},
followUps: {
enabled: true,
limit: {isUnlimited: true, maxFollowUps: 0},
cadenceDays: [4503599627370496],
tailCadenceDays: 4503599627370496,
relevantPostAcceleration: {enabled: true}
}
}
}
})
};
fetch('https://api.goextrovert.com/client/v2/campaign/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.goextrovert.com/client/v2/campaign/{id}",
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([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'voiceId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'skipTeammatesLeads' => true,
'outreach' => [
'warmUp' => [
'enabled' => true,
'direct' => [
'enabled' => true,
'commentTarget' => 123
],
'indirect' => [
'enabled' => true,
'commentTarget' => 123
],
'skipWarmUpWhenNoRecentPosts' => true,
'stopWaiting' => [
'enabled' => true,
'afterDays' => 123
]
],
'connectionRequests' => [
'enabled' => true
],
'directMessages' => [
'enabled' => true,
'firstOutreach' => [
'enabled' => true,
'waitAfterAcceptance' => [
'enabled' => true,
'days' => 4503599627370496
]
],
'followUps' => [
'enabled' => true,
'limit' => [
'isUnlimited' => true,
'maxFollowUps' => 0
],
'cadenceDays' => [
4503599627370496
],
'tailCadenceDays' => 4503599627370496,
'relevantPostAcceleration' => [
'enabled' => true
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.goextrovert.com/client/v2/campaign/{id}"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.goextrovert.com/client/v2/campaign/{id}")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.goextrovert.com/client/v2/campaign/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"voiceId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"skipTeammatesLeads\": true,\n \"outreach\": {\n \"warmUp\": {\n \"enabled\": true,\n \"direct\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"indirect\": {\n \"enabled\": true,\n \"commentTarget\": 123\n },\n \"skipWarmUpWhenNoRecentPosts\": true,\n \"stopWaiting\": {\n \"enabled\": true,\n \"afterDays\": 123\n }\n },\n \"connectionRequests\": {\n \"enabled\": true\n },\n \"directMessages\": {\n \"enabled\": true,\n \"firstOutreach\": {\n \"enabled\": true,\n \"waitAfterAcceptance\": {\n \"enabled\": true,\n \"days\": 4503599627370496\n }\n },\n \"followUps\": {\n \"enabled\": true,\n \"limit\": {\n \"isUnlimited\": true,\n \"maxFollowUps\": 0\n },\n \"cadenceDays\": [\n 4503599627370496\n ],\n \"tailCadenceDays\": 4503599627370496,\n \"relevantPostAcceleration\": {\n \"enabled\": true\n }\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": null,
"message": "Operation completed successfully"
}{
"status": "error",
"data": null,
"message": "An error occurred while processing the request"
}Authorizations
API Key for authentication
Path Parameters
Body
application/json
Campaign id to update.
Updated display name.
Minimum string length:
1Voice id the campaign should use after the update. Always required: detaching a Voice is intentionally not possible through this API (internally an omitted field would mean 'remove'), so pass the current voice.id to keep it or another valid id to switch.
Prospects campaigns: skip profiles already present in teammates' campaigns. Enabling is rejected if duplicate prospects already exist; resolve those duplicates first. Keep the stored value for Topic campaigns.
Whole comment policy of the campaign. commenting is replaced as a whole, never deep-merged: omit it to leave the stored policy untouched, or state the complete policy you want. A scalar omitted inside a group that IS stated therefore means off/none, not “keep the stored value”. A TARGET_USER (Prospects) campaign states strategy, postFilters, frequency and feedCleanup, and may state indirectCommentingEnabled and publishingPace; a KEYWORD (Topic) campaign states strategy and postFilters only — every other member is People-only and must be omitted. Whole-policy replacement, not a deep merge. Omit to retain it, except that disabling the last warm-up comment path may change stored FINISH_FIRST to FRESHNESS_FIRST; re-read after that outreach change.
Show child attributes
Show child attributes
Optional deep-partial update of the private-outreach settings. Send only the nested fields that should change: omitted fields keep their stored value, an explicit false is applied, and the backend validates the merged result before saving it.
Show child attributes
Show child attributes