Criar campanha

Cria uma campanha de e-mail no workspace.

POSThttps://external-api.lip7.com.br/api/external/email/campaigns
Escopoemail:campaigns:writeSíncrono — responde 200 com os dados

Operação síncrona — responde 201 com a campanha criada. A campanha nasce em DRAFT, a menos que scheduledFor seja informado.

Body
namestringobrigatório

Nome interno da campanha.

subjectstringobrigatório

Assunto do e-mail.

fromNamestringobrigatório

Nome de exibição do remetente.

fromEmailstringobrigatório

E-mail remetente verificado.

replyTostringopcional

E-mail para respostas.

templateIdstringopcional

ID do template de e-mail a usar.

htmlContentstringopcional

Corpo HTML, quando não usa template.

textContentstringopcional

Versão em texto puro.

segmentIdstringopcional

ID de um segmento de contatos.

segmentRulesarrayopcional

Regras de segmentação.

recipientFilterarrayopcional

Filtros de destinatários.

scheduledForstringopcional

Data e hora no formato ISO 8601. Se informado, a campanha já nasce agendada.

sendStrategystringopcional

Estratégia de disparo.

valoresTHROTTLEDALL_AT_ONCE
attachmentsarrayopcional

Anexos enviados a todos os destinatários da campanha, com o mesmo formato do envio transacional — veja Anexos. Ficam guardados com a campanha e são reenviados em cada disparo.

Campanha com anexo envia mais devagar

Quando a campanha tem anexo, o disparo passa a ser feito e-mail a e-mail em vez de em lote — veja Anexos.

Requisição
{
  "name": "Promo Junho",
  "subject": "Ofertas especiais",
  "fromName": "Sua Empresa",
  "fromEmail": "marketing@suaempresa.com",
  "templateId": "tpl_email_123",
  "segmentId": "seg_ativos",
  "sendStrategy": "THROTTLED"
}
Resposta
{
  "success": true,
  "data": {
    "id": "camp_...",
    "name": "Promo Junho",
    "status": "DRAFT"
  }
}