Skip to Content
1MSG
ReferenceCampaigns API

Mudar o horário agendado

PATCH
/api/v1/campaigns/{campaignId}/schedule

scheduledAt é um novo instante futuro em ISO-8601 com Z ou deslocamento numérico. Só uma campanha já agendada pode ser remarcada.

Authorization

bearer
headerAuthorizationBearer <API key>

Chave gerada em Settings → Developer → API key. Os métodos do Inbox precisam do escopo Inbox. Os métodos de Campaigns precisam do escopo Campaigns.

Path Parameters

campaignId*string

id da campanha retornado na criação ou na lista.

Request Body

application/json
  1. body
scheduledAt*string

Novo instante futuro em ISO-8601 com Z ou deslocamento numérico, por exemplo 2026-11-02T09:00:00Z. Obrigatório. Só uma campanha já agendada pode ser remarcada.

Response Body

application/json
  1. response
id*string

id da campanha.

name*string

Título da campanha.

channelId*string

Canal que envia a campanha.

segmentId*string

Segmento usado como público.

status*string

Status da campanha.

Value in"draft""sending""pause""completed""failed""scheduled"
content*||

Template ou texto da sessão salvo na campanha.

sentAt*|

Quando o envio começou, ou null se ainda não começou.

Formatdate-time
scheduledAt*|

Instante UTC de um envio agendado, ou null.

Formatdate-time
queuedRemaining*number

Destinatários que ainda aguardam o envio.

sentThisPortion*number

Envios de template já iniciados na janela atual do limite.

dailyLimit*|

Quantos envios de template este canal pode iniciar em 24 horas corridas. Vem do limite do canal (waba_info.current_limit), não de uma configuração da campanha. null quando o limite é desconhecido ou ilimitado. Texto da sessão não conta.

nextPortionAt*|

Quando a próxima leva de templates pode começar depois que a janela do limite encheu. null quando nenhuma leva está esperando.

Formatdate-time
createdAt*string

Quando a campanha foi criada.

Formatdate-time
updatedAt*string

Quando a campanha foi atualizada pela última vez.

Formatdate-time
Example Request
curl -X PATCH 'https://api.1msg.io/api/v1/campaigns/string/schedule' \  -H 'Content-Type: application/json' \  -d '{  "scheduledAt": "string"}'
Example Response200
{  "id": "cm3campaign01",  "name": "April restock",  "channelId": "cm3channel01",  "segmentId": "cm3segment01",  "status": "draft",  "content": {    "mode": "text",    "text": "Hello"  },  "sentAt": "2026-11-01T09:00:00.000Z",  "scheduledAt": "2026-11-01T09:00:00.000Z",  "queuedRemaining": 0,  "sentThisPortion": 0,  "dailyLimit": 1000,  "nextPortionAt": null,  "createdAt": "2026-11-01T09:00:00.000Z",  "updatedAt": "2026-11-01T09:00:00.000Z"}