Update campaign
Same body as creation. Only valid while the campaign has not started sending —
after that, use /pause, /resume, /cancel or /restart.
Sending file again replaces the list of recipients and restarts the import; without
mapping, the column mapping is rebuilt automatically from the new header.
curl --request PUT \
--url https://api.connectadesk.com/api/v1/campaigns/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"send_name": "Black Friday 2026",
"slug": "black-friday-2026",
"channel": {
"id": 4
},
"type": "connecta_contacts",
"message_type": "template",
"init_timestamp": "2026-11-24T09:00:00-03:00",
"send_avg_time": 30,
"queue": {
"id": 7
},
"import_contacts_mode": "tags",
"contacts": [
4821,
4822
],
"tags": [
7,
12
],
"tags_mode": "only",
"tags_operator": "or",
"mapping": [
{
"header": "Telefone",
"value": "contact_number"
}
],
"messages": [
"Olá {{name}}, temos uma novidade para você!"
],
"template": {
"name": "promocao_black_friday",
"language": "pt_BR",
"parameters": {
"header": [
"<string>"
],
"body": [
"Maria",
"30%"
]
}
},
"pause_timestamp": "2026-11-24T21:00:00-03:00",
"restart_timestamp": "2026-11-25T09:00:00-03:00",
"open_ticket": true,
"add_tags": [
19
]
}
'import requests
url = "https://api.connectadesk.com/api/v1/campaigns/{id}"
payload = {
"send_name": "Black Friday 2026",
"slug": "black-friday-2026",
"channel": { "id": 4 },
"type": "connecta_contacts",
"message_type": "template",
"init_timestamp": "2026-11-24T09:00:00-03:00",
"send_avg_time": 30,
"queue": { "id": 7 },
"import_contacts_mode": "tags",
"contacts": [4821, 4822],
"tags": [7, 12],
"tags_mode": "only",
"tags_operator": "or",
"mapping": [
{
"header": "Telefone",
"value": "contact_number"
}
],
"messages": ["Olá {{name}}, temos uma novidade para você!"],
"template": {
"name": "promocao_black_friday",
"language": "pt_BR",
"parameters": {
"header": ["<string>"],
"body": ["Maria", "30%"]
}
},
"pause_timestamp": "2026-11-24T21:00:00-03:00",
"restart_timestamp": "2026-11-25T09:00:00-03:00",
"open_ticket": True,
"add_tags": [19]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
send_name: 'Black Friday 2026',
slug: 'black-friday-2026',
channel: {id: 4},
type: 'connecta_contacts',
message_type: 'template',
init_timestamp: '2026-11-24T09:00:00-03:00',
send_avg_time: 30,
queue: {id: 7},
import_contacts_mode: 'tags',
contacts: [4821, 4822],
tags: [7, 12],
tags_mode: 'only',
tags_operator: 'or',
mapping: [{header: 'Telefone', value: 'contact_number'}],
messages: ['Olá {{name}}, temos uma novidade para você!'],
template: {
name: 'promocao_black_friday',
language: 'pt_BR',
parameters: {header: ['<string>'], body: JSON.stringify(['Maria', '30%'])}
},
pause_timestamp: '2026-11-24T21:00:00-03:00',
restart_timestamp: '2026-11-25T09:00:00-03:00',
open_ticket: true,
add_tags: [19]
})
};
fetch('https://api.connectadesk.com/api/v1/campaigns/{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.connectadesk.com/api/v1/campaigns/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'send_name' => 'Black Friday 2026',
'slug' => 'black-friday-2026',
'channel' => [
'id' => 4
],
'type' => 'connecta_contacts',
'message_type' => 'template',
'init_timestamp' => '2026-11-24T09:00:00-03:00',
'send_avg_time' => 30,
'queue' => [
'id' => 7
],
'import_contacts_mode' => 'tags',
'contacts' => [
4821,
4822
],
'tags' => [
7,
12
],
'tags_mode' => 'only',
'tags_operator' => 'or',
'mapping' => [
[
'header' => 'Telefone',
'value' => 'contact_number'
]
],
'messages' => [
'Olá {{name}}, temos uma novidade para você!'
],
'template' => [
'name' => 'promocao_black_friday',
'language' => 'pt_BR',
'parameters' => [
'header' => [
'<string>'
],
'body' => [
'Maria',
'30%'
]
]
],
'pause_timestamp' => '2026-11-24T21:00:00-03:00',
'restart_timestamp' => '2026-11-25T09:00:00-03:00',
'open_ticket' => true,
'add_tags' => [
19
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.connectadesk.com/api/v1/campaigns/{id}"
payload := strings.NewReader("{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.connectadesk.com/api/v1/campaigns/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/campaigns/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 77,
"name": "Promoção de inverno",
"status": "processing",
"scheduledAt": "2026-08-19T12:00:00.000Z",
"completedAt": null,
"contactListId": 12,
"channelId": 11,
"createdAt": "2026-08-17T18:20:00.000Z",
"updatedAt": "2026-08-19T12:00:03.221Z"
}
}{
"error": {
"code": "ERR_API_NOT_FOUND",
"message": "Registro não encontrado."
}
}{
"error": {
"code": "ERR_API_VALIDATION",
"message": "O parâmetro `application` é obrigatório e aceita \"contact\" ou \"card\"."
}
}Authorizations
API token in the sk_live_… format.
Path Parameters
Body
Campaign settings. Which fields are required depends on type (where the recipients
come from) and message_type (what will be sent).
Campaign name, as it appears in the listing.
"Black Friday 2026"
Short campaign identifier, used in reports.
"black-friday-2026"
Outbound channel. See the available ones in GET /channels.
Show child attributes
Show child attributes
Where the recipients come from:
file (spreadsheet sent in the file field) or connecta_contacts (your contact base).
file, connecta_contacts "connecta_contacts"
What will be sent: message (free text, unofficial channels only) or template
(approved official WhatsApp template). Any other value returns 422
(ERR_API_CAMPAIGN_MESSAGE_TYPE_INVALID).
message, template "template"
When the sending starts. It must be in the future.
Without a time zone, your company's time zone applies. 2026-11-24T09:00:00 starts at
nine in the morning in the time zone set on the company — the same one you see in the
panel. If you prefer to be explicit, send it with an offset
(2026-11-24T09:00:00-03:00) or in UTC (2026-11-24T12:00:00.000Z), and the value is
then respected as it is.
"2026-11-24T09:00:00-03:00"
Average interval between sends, in seconds. The longer it is, the slower and the safer for the number.
30
Queue of the ticket the send creates. Required. It applies either way: with
open_ticket: true the conversation opens already in that queue; without it, the ticket
stays closed, but in the queue.
It is the queueId that decides where the ticket lands. Without a queue it would be
created loose, showing up for no team — and you would only find out after the campaign
ran. That is why creating or editing without queue responds 422
(ERR_API_CAMPAIGN_QUEUE_REQUIRED). See the queues in GET /queues.
Show child attributes
Show child attributes
Required with type: connecta_contacts. Picks contacts one by one or by tags.
contacts, tags "tags"
Contact ids, with import_contacts_mode: contacts. No file is needed:
the list becomes the campaign's recipient base.
Every id must belong to this company — an id from outside returns 422
(ERR_API_CAMPAIGN_IDS_NOT_FOUND) with the list of what does not match.
[4821, 4822]
Tag ids, with import_contacts_mode: tags. The recipients are the contacts that
match the tags, according to tags_mode and tags_operator. No file is needed
here either, and the ids must belong to this company.
[7, 12]
How the tags filter the base: only (only those who have them), except (those who
do not) or all (the whole base, ignoring the tags).
all, except, only "only"
With more than one tag: and requires all of them, or accepts any one of them.
and, or "or"
Mapping between the spreadsheet columns and the system fields, with type: file.
Can be omitted. Without it, the mapping is built automatically from the header:
each column is compared (ignoring accents and case) with the known names of each
field — for example telefone, celular, whatsapp, fone, numero and phone
become contact_number; nome, contato and cliente become contact_name;
cpf, cnpj and documento become contact_cpfcnpj. For custom fields, the header
is compared with the key and with the field name. A column that matches nothing
comes in as dont_import, and the first column wins when two would point to the
same field.
The phone and the name are required. If the automatic mapping does not recognize one
of these columns, or if the mapping sent does not include contact_number and
contact_name, creation returns 422 (ERR_API_CAMPAIGN_MAPPING_PHONE_REQUIRED or
ERR_API_CAMPAIGN_MAPPING_NAME_REQUIRED) instead of creating a campaign that would fail
on import.
Show child attributes
Show child attributes
Campaign texts, with message_type: message. More than one text makes the system
alternate between them on each send. Accepts the contact variables ({{name}},
{{email}}…). The attachment of each message goes in message_attachment_<position>.
[
"Olá {{name}}, temos uma novidade para você!"
]
Approved template, with message_type: template. Send only the name and the
variables — the system builds the rest and checks it against the REAL templates of
the channel, so a wrong name or a missing variable shows up here and not on the day
of the send. See the available ones in GET /channels/{id}/templates.
Show child attributes
Show child attributes
Start of the daily pause window (for example, to avoid sending in the middle of the night).
Same time zone rule as init_timestamp.
"2026-11-24T21:00:00-03:00"
End of the pause window. Required when pause_timestamp is given.
Same time zone rule as init_timestamp.
"2026-11-25T09:00:00-03:00"
Opens the ticket at the moment of the send: it comes in as pending in the queue
queue and shows up for the agents right away. Without it the send goes out with the
ticket closed, and the conversation only opens if the contact replies.
true
Tags applied to every contact the campaign reaches.
[19]
Response
OK
Show child attributes
Show child attributes
{
"id": 77,
"name": "Promoção de inverno",
"status": "processing",
"scheduledAt": "2026-08-19T12:00:00.000Z",
"completedAt": null,
"contactListId": 12,
"channelId": 11,
"createdAt": "2026-08-17T18:20:00.000Z",
"updatedAt": "2026-08-19T12:00:03.221Z"
}
curl --request PUT \
--url https://api.connectadesk.com/api/v1/campaigns/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"send_name": "Black Friday 2026",
"slug": "black-friday-2026",
"channel": {
"id": 4
},
"type": "connecta_contacts",
"message_type": "template",
"init_timestamp": "2026-11-24T09:00:00-03:00",
"send_avg_time": 30,
"queue": {
"id": 7
},
"import_contacts_mode": "tags",
"contacts": [
4821,
4822
],
"tags": [
7,
12
],
"tags_mode": "only",
"tags_operator": "or",
"mapping": [
{
"header": "Telefone",
"value": "contact_number"
}
],
"messages": [
"Olá {{name}}, temos uma novidade para você!"
],
"template": {
"name": "promocao_black_friday",
"language": "pt_BR",
"parameters": {
"header": [
"<string>"
],
"body": [
"Maria",
"30%"
]
}
},
"pause_timestamp": "2026-11-24T21:00:00-03:00",
"restart_timestamp": "2026-11-25T09:00:00-03:00",
"open_ticket": true,
"add_tags": [
19
]
}
'import requests
url = "https://api.connectadesk.com/api/v1/campaigns/{id}"
payload = {
"send_name": "Black Friday 2026",
"slug": "black-friday-2026",
"channel": { "id": 4 },
"type": "connecta_contacts",
"message_type": "template",
"init_timestamp": "2026-11-24T09:00:00-03:00",
"send_avg_time": 30,
"queue": { "id": 7 },
"import_contacts_mode": "tags",
"contacts": [4821, 4822],
"tags": [7, 12],
"tags_mode": "only",
"tags_operator": "or",
"mapping": [
{
"header": "Telefone",
"value": "contact_number"
}
],
"messages": ["Olá {{name}}, temos uma novidade para você!"],
"template": {
"name": "promocao_black_friday",
"language": "pt_BR",
"parameters": {
"header": ["<string>"],
"body": ["Maria", "30%"]
}
},
"pause_timestamp": "2026-11-24T21:00:00-03:00",
"restart_timestamp": "2026-11-25T09:00:00-03:00",
"open_ticket": True,
"add_tags": [19]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
send_name: 'Black Friday 2026',
slug: 'black-friday-2026',
channel: {id: 4},
type: 'connecta_contacts',
message_type: 'template',
init_timestamp: '2026-11-24T09:00:00-03:00',
send_avg_time: 30,
queue: {id: 7},
import_contacts_mode: 'tags',
contacts: [4821, 4822],
tags: [7, 12],
tags_mode: 'only',
tags_operator: 'or',
mapping: [{header: 'Telefone', value: 'contact_number'}],
messages: ['Olá {{name}}, temos uma novidade para você!'],
template: {
name: 'promocao_black_friday',
language: 'pt_BR',
parameters: {header: ['<string>'], body: JSON.stringify(['Maria', '30%'])}
},
pause_timestamp: '2026-11-24T21:00:00-03:00',
restart_timestamp: '2026-11-25T09:00:00-03:00',
open_ticket: true,
add_tags: [19]
})
};
fetch('https://api.connectadesk.com/api/v1/campaigns/{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.connectadesk.com/api/v1/campaigns/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'send_name' => 'Black Friday 2026',
'slug' => 'black-friday-2026',
'channel' => [
'id' => 4
],
'type' => 'connecta_contacts',
'message_type' => 'template',
'init_timestamp' => '2026-11-24T09:00:00-03:00',
'send_avg_time' => 30,
'queue' => [
'id' => 7
],
'import_contacts_mode' => 'tags',
'contacts' => [
4821,
4822
],
'tags' => [
7,
12
],
'tags_mode' => 'only',
'tags_operator' => 'or',
'mapping' => [
[
'header' => 'Telefone',
'value' => 'contact_number'
]
],
'messages' => [
'Olá {{name}}, temos uma novidade para você!'
],
'template' => [
'name' => 'promocao_black_friday',
'language' => 'pt_BR',
'parameters' => [
'header' => [
'<string>'
],
'body' => [
'Maria',
'30%'
]
]
],
'pause_timestamp' => '2026-11-24T21:00:00-03:00',
'restart_timestamp' => '2026-11-25T09:00:00-03:00',
'open_ticket' => true,
'add_tags' => [
19
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.connectadesk.com/api/v1/campaigns/{id}"
payload := strings.NewReader("{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.connectadesk.com/api/v1/campaigns/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/campaigns/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"send_name\": \"Black Friday 2026\",\n \"slug\": \"black-friday-2026\",\n \"channel\": {\n \"id\": 4\n },\n \"type\": \"connecta_contacts\",\n \"message_type\": \"template\",\n \"init_timestamp\": \"2026-11-24T09:00:00-03:00\",\n \"send_avg_time\": 30,\n \"queue\": {\n \"id\": 7\n },\n \"import_contacts_mode\": \"tags\",\n \"contacts\": [\n 4821,\n 4822\n ],\n \"tags\": [\n 7,\n 12\n ],\n \"tags_mode\": \"only\",\n \"tags_operator\": \"or\",\n \"mapping\": [\n {\n \"header\": \"Telefone\",\n \"value\": \"contact_number\"\n }\n ],\n \"messages\": [\n \"Olá {{name}}, temos uma novidade para você!\"\n ],\n \"template\": {\n \"name\": \"promocao_black_friday\",\n \"language\": \"pt_BR\",\n \"parameters\": {\n \"header\": [\n \"<string>\"\n ],\n \"body\": [\n \"Maria\",\n \"30%\"\n ]\n }\n },\n \"pause_timestamp\": \"2026-11-24T21:00:00-03:00\",\n \"restart_timestamp\": \"2026-11-25T09:00:00-03:00\",\n \"open_ticket\": true,\n \"add_tags\": [\n 19\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": 77,
"name": "Promoção de inverno",
"status": "processing",
"scheduledAt": "2026-08-19T12:00:00.000Z",
"completedAt": null,
"contactListId": 12,
"channelId": 11,
"createdAt": "2026-08-17T18:20:00.000Z",
"updatedAt": "2026-08-19T12:00:03.221Z"
}
}{
"error": {
"code": "ERR_API_NOT_FOUND",
"message": "Registro não encontrado."
}
}{
"error": {
"code": "ERR_API_VALIDATION",
"message": "O parâmetro `application` é obrigatório e aceita \"contact\" ou \"card\"."
}
}