---
title: "Trigger a scenario"
method: POST
path: "/v1/voice-campaigns"
tags: ["Voice campaigns"]
---

# Trigger a scenario

`POST /v1/voice-campaigns`

Launches a voice campaign that places an outbound call using a pre-configured scenario. Track progress with the returned voice campaign `id`.

## Request body

- object — Scenario and contact details for the campaign.
  - `voice_campaign` VoiceCampaignResponse, required — Represents a voice campaign that places an outbound call running a pre-approved call flow.
    - `callflow_id` integer, required — Unique identifier of the call flow to launch, listed on the Call flows page. Every scenario must be pre-approved by the Wavix Service Operations team before it can be used in production.
    - `caller_id` string, required — Phone number on the account used as the Caller ID for the outbound call, in E.164 format.
    - `contact` string, required — Destination phone number the outbound call is placed to, in E.164 format.
    - `callback_url` string — Webhook URL that receives voice campaign status updates.

## Response `201`

Returns the launched voice campaign.

- VoiceCampaignsCreateResponse
  - `voice_campaign` object
    - `id` integer — Unique identifier of the voice campaign.
    - `status` string — Current status of the voice campaign, such as `in_progress`.
    - `timestamp` string, date-time — Timestamp when the voice campaign was created, in ISO 8601 format.
    - `caller_id` string — Phone number used as the Caller ID for the outbound call, in E.164 format.
    - `contact` string — Destination phone number the outbound call is placed to, in E.164 format.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.
- `422` — Returns when the account has insufficient funds to launch the campaign.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)