---
title: "Launch initiative"
method: POST
path: "/api/v1/initiatives/{id}/launch"
tags: ["Initiatives"]
---

# Launch initiative

`POST /api/v1/initiatives/{id}/launch`

Launch a draft initiative — it goes active and Boom starts reaching out. A WhatsApp initiative needs an approved template first. Requires an org admin.

## Path parameters

- `id` string, required — The initiative id.

## Response `201`

Success

- object
  - `id` string, required — Initiative id.
  - `name` string, required
  - `channel` 'WHATSAPP' | 'EMAIL', required
  - `status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'COMPLETED' | 'CANCELED', required
  - `language` string, required — Conversation language, e.g. `es`.
  - `objective` string, nullable, required
  - `isRecurring` boolean, required — Whether the initiative keeps processing newly added participants on a schedule.
  - `flagCondition` string, nullable, required — Natural-language condition; matching conversations get flagged during analysis.
  - `identityDeflection` string, nullable, required — Custom reply when a contact asks whether they are talking to a bot.
  - `createdAt` string, required — ISO 8601 timestamp.
  - `updatedAt` string, required — ISO 8601 timestamp.
  - `activatedAt` string, nullable, required
  - `completedAt` string, nullable, required
  - `canceledAt` string, nullable, required
  - `pausedAt` string, nullable, required
  - `context` string, nullable, required
  - `maxAttempts` integer, required
  - `guidingQuestions` object[], required
    - `id` string, required
    - `questionText` string, required
    - `answerType` string, required
    - `priority` integer, required
    - `scaleMin` integer, nullable, required
    - `scaleMax` integer, nullable, required
    - `options` object[], required
      - `id` string, required
      - `label` string, required
      - `position` integer, required

## Other responses

- `400` — Validation failed or the request cannot proceed.
- `401` — Missing, malformed, or revoked API key.
- `404` — The resource does not exist in this organization.
- `409` — Conflicts with the current state (duplicates, wrong lifecycle state).
- `422` — The request is well-formed but semantically invalid.
- `429` — Rate limit exceeded — retry after `Retry-After`.
- `500` — Internal server error.
- `503` — Transient error — retry with a narrower request.

---

[API](https://skmtc.net/useboom/apis/boom-api.md) · [All operations](https://skmtc.net/useboom/apis/boom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useboom/boom-api/versions/00f873e07076/schema)