---
title: "Crear Campaign manual"
method: POST
path: "/campaigns/manual"
tags: ["Campaigns"]
---

# Crear Campaign manual

`POST /campaigns/manual`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/campaigns/manual`
- Auth: API key in header `x-api-key`

Crea una campaña manual, acotada por `start_date` y `finish_date`.

Se usa cuando los envíos no se programan por adelantado, sino que se revisan y disparan después desde la aplicación: a diferencia de la campaña programada, esta operación no agenda ningún envío y por eso no acepta `outbound_dates`.

La campaña queda vacía; las deudas a contactar se asocian con `POST /campaigns/manual/invoices`.

## Headers

- `x-account-key` string: Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

## Request body

- CampaignManual: Objeto Campaign, representa una **campaña**. Esto es una agrupación específica de deudas y deudores a contactar. Cada vez que se genera un contacto masivo se hace a partir de estas campañas, que nos dicen a qué deudas contactar. Esta campaña no tiene los envíos automáticos activados y tendrán que ser realizados y revisados posteriormente.
  - `finish_date` string, date, required: Fecha en que se termina la campaña. Debe caer entre hoy y los próximos 56 días.
  - `intention` string: Identificador público de la Intention que define el mensaje a enviar. Se entrega `intention` o `sequence`, nunca ambos.
  - `name` string, required: Nombre con el que se identifica la campaña dentro de la aplicación.
  - `sequence` string: Identificador público de la Sequence que define los recordatorios a enviar. Se entrega `intention` o `sequence`, nunca ambos.
  - `start_date` string, date, required: Fecha en que se inicia la campaña. Debe caer entre hoy y los próximos 56 días.

## Response `201`

La campaña fue creada, sin envíos agendados.

- ManualCampaignCreatedMessage: Resultado de crear una campaña manual, con el identificador de la campaña recién creada.
  - `id_campaign` string, required: Identificador público de la campaña creada. Se necesita para asociarle deudas y para archivarla más adelante.
  - `message` string, required: Descripción legible del resultado de la operación.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: La Intention o la Sequence referenciada no existe en la organización autenticada.
- `422`: La Sequence de la campaña envía por WhatsApp y la organización no está habilitada para hacerlo: le falta configuración de mensajería, o le faltan campos en ella. El detalle indica cuáles.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/campaigns/manual/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)