---
title: "Create new OMNI failover scenario"
method: POST
path: "/omni/1/scenarios"
tags: ["channels", "omni-failover", "configuration"]
---

# Create new OMNI failover scenario

`POST /omni/1/scenarios`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/omni/1/scenarios`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Define which channels, and in which order, would you like to use in your message failover scenario. If the delivery of the message fails for the first channel, we will use the next channel in your scenario, and so on.

## Request body

- 04790a6ae08cb63186016b6e4b8eb1c003a31d6a3227220686470a5721dc2d02CreateOrUpdateScenarioRequest
  - `name` string: OMNI scenario name.
  - `flow` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11Step[]: Sender used in OMNI scenario’s step for sending message.
    - `from` string: Sender used in OMNI scenario’s step for sending message.
    - `channel` 'SMS' | 'EMAIL' | 'VOICE' | 'PUSH' | 'VIBER' | 'LINE' | 'VKONTAKTE' | 'KAKAO_CHINGU' | 'KAKAO_ALIM' | 'WHATSAPP': Channel that was used for message delivering.
  - `default` boolean: Indicates if created scenario should be set as a default.

## Response `201`

created

- 9ac20aaa973a4193ff0ca88a25f8778624dcef15967a470e5d05a9222eb15517Scenario
  - `key` integer: Key used to uniquely identify OMNI scenario.
  - `name` string: OMNI scenario name.
  - `flow` E204fb2d0d1568cbfe90b245006e95aab18e580484154f085b8348d2e991bc11Step[]: Sender used in OMNI scenario’s step for sending message.
    - `from` string: Sender used in OMNI scenario’s step for sending message.
    - `channel` 'SMS' | 'EMAIL' | 'VOICE' | 'PUSH' | 'VIBER' | 'LINE' | 'VKONTAKTE' | 'KAKAO_CHINGU' | 'KAKAO_ALIM' | 'WHATSAPP': Channel that was used for message delivering.
  - `default` boolean: Indicates if created scenario should be set as a default.

## Other responses

- `400`: invalid scenario
- `401`: Unauthorized
- `403`: Forbidden
- `409`: creating scenario is forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)