Actualizar campaña

curl --request PUT \
  --url https://api.jelou.ai/v1/campaigns/{campaignId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "promo_fin_de_mes",
  "scheduledAt": "2026-09-27T11:00:00-05:00"
}
'

import requests

url = "https://api.jelou.ai/v1/campaigns/{campaignId}"

payload = {
    "name": "promo_fin_de_mes",
    "scheduledAt": "2026-09-27T11:00:00-05:00"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'promo_fin_de_mes', scheduledAt: '2026-09-27T11:00:00-05:00'})
};

fetch('https://api.jelou.ai/v1/campaigns/{campaignId}', 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.jelou.ai/v1/campaigns/{campaignId}",
  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([
    'name' => 'promo_fin_de_mes',
    'scheduledAt' => '2026-09-27T11:00:00-05:00'
  ]),
  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;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jelou.ai/v1/campaigns/{campaignId}"

	payload := strings.NewReader("{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	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.jelou.ai/v1/campaigns/{campaignId}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jelou.ai/v1/campaigns/{campaignId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": [
    "Campaign has been updated."
  ],
  "statusMessage": "success",
  "status": 1
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

PUT

campaigns

{campaignId}

Actualizar campaña

curl --request PUT \
  --url https://api.jelou.ai/v1/campaigns/{campaignId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "promo_fin_de_mes",
  "scheduledAt": "2026-09-27T11:00:00-05:00"
}
'

import requests

url = "https://api.jelou.ai/v1/campaigns/{campaignId}"

payload = {
    "name": "promo_fin_de_mes",
    "scheduledAt": "2026-09-27T11:00:00-05:00"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'promo_fin_de_mes', scheduledAt: '2026-09-27T11:00:00-05:00'})
};

fetch('https://api.jelou.ai/v1/campaigns/{campaignId}', 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.jelou.ai/v1/campaigns/{campaignId}",
  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([
    'name' => 'promo_fin_de_mes',
    'scheduledAt' => '2026-09-27T11:00:00-05:00'
  ]),
  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;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jelou.ai/v1/campaigns/{campaignId}"

	payload := strings.NewReader("{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	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.jelou.ai/v1/campaigns/{campaignId}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jelou.ai/v1/campaigns/{campaignId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"promo_fin_de_mes\",\n  \"scheduledAt\": \"2026-09-27T11:00:00-05:00\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": [
    "Campaign has been updated."
  ],
  "statusMessage": "success",
  "status": 1
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

Endpoint

PUT https://api.jelou.ai/v1/campaigns/{campaignId}

Solo puedes actualizar campañas en estado SCHEDULED. Una campaña que ya empezó a enviarse, o que ya terminó, no se puede actualizar.

Parámetros de ruta

Propiedad	Tipo	Descripción	Requerido
campaignId	string	ID de la campaña que quieres actualizar. Lo obtienes con el endpoint `GET /v1/campaigns`.	Sí

Cuerpo de la solicitud

Propiedad	Tipo	Descripción	Requerido
name	string	Nuevo nombre de la campaña.	No
scheduledAt	string	Nueva fecha y hora de envío, en formato ISO 8601 con zona horaria. Debe ser posterior a la fecha y hora actual.	No

Formato de scheduledAt

scheduledAt usa el formato ISO 8601: YYYY-MM-DDTHH:mm:ss seguido de la zona horaria.

Ejemplo	Significado
`2026-09-27T16:00:00Z`	27 de septiembre de 2026 a las 16:00 en UTC.
`2026-09-27T11:00:00-05:00`	27 de septiembre de 2026 a las 11:00 en UTC-5 (Ecuador, Colombia, Perú). Es el mismo instante que el ejemplo anterior.

Si la fecha no es válida o ya pasó, la API responde con 422 y no cambia la campaña.

Ejemplo de solicitud

curl --request PUT \
  --url https://api.jelou.ai/v1/campaigns/CAMPAIGN_ID \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "promo_fin_de_mes_v2"
  }'

Respuestas

200 - Respuesta exitosa

{
  "message": ["Campaign has been updated."],
  "statusMessage": "success",
  "status": 1
}

401 - Unauthorized

{
  "message": "Authentication failed"
}

404 - Not Found

{
  "message": ["Campaign not found"],
  "statusMessage": "failed",
  "status": 0
}

422 - Unprocessable Entity

{
  "message": ["Los valores ingresados no son correctos."],
  "statusMessage": "failed",
  "status": 0,
  "validationError": {
    "scheduledAt": [
      {
        "es": "El campo scheduledAt debe ser posterior a la fecha actual",
        "en": "The scheduledAt field must be later than the current date",
        "pt": "O campo scheduledAt deve ser posterior à data atual"
      }
    ]
  }
}

500 - Internal Server Error

{
  "message": ["We are having trouble processing your request. Please try again later."],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E0000",
    "key": "UNKNOWN_ERROR",
    "description": "Error to be thrown when it couldn't be determined the reason of failure",
    "developerMessages": {
      "es": "Error inesperado occurido, revisar logs.",
      "en": "Unexpected error occurred, check logs."
    },
    "clientMessages": {
      "es": "Estamos teniendo problemas procesando la solicitud. Por favor intenta más tarde.",
      "en": "We are having trouble processing your request. Please try again later.",
      "pt": "Estamos tendo problemas com o processo da solicitação. Por favor tente mais tarde."
    }
  }
}

Autorizaciones

Authorization

string

header

requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

campaignId

string

requerido

ID de la campaña (24 caracteres hexadecimales).

Ejemplo:

"CAMPAIGN_ID"

Cuerpo

application/json

name

string

Nuevo nombre de la campaña.

Ejemplo:

"promo_fin_de_mes"

scheduledAt

string<date-time>

Nueva fecha y hora de envío en formato ISO 8601 con zona horaria (Z o un desfase como -05:00). Debe ser posterior a la fecha actual.

Ejemplo:

"2026-09-27T11:00:00-05:00"

Respuesta

Campaign updated

message

string[]

Ejemplo:

["Campaign has been updated."]

statusMessage

string

Ejemplo:

"success"

status

integer

Ejemplo:

1

API reference

Envío de mensajes

Campañas

Conversaciones

Etiquetas

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Canal Personalizado

Gestión de Memoria

Actualizar campaña

Endpoint

Parámetros de ruta

Cuerpo de la solicitud

Formato de scheduledAt

Ejemplo de solicitud

Respuestas

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Endpoint

​Parámetros de ruta

​Cuerpo de la solicitud

​Formato de scheduledAt

​Ejemplo de solicitud

​Respuestas

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Endpoint

Parámetros de ruta

Cuerpo de la solicitud

Formato de scheduledAt

Ejemplo de solicitud

Respuestas