---
title: "Create markup language call"
method: POST
path: "/markuplanguage/1/create"
tags: ["channels", "voice", "calls-markup-language", "calls-markup-language-create"]
---

# Create markup language call

`POST /markuplanguage/1/create`

## 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/markuplanguage/1/create`
- 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

Create a new markup language call which will be processed according to provided markup instructions.

## Request body

- Eaaf11bb9830fc826a8597df01bea6f2a14ef6d1ed129a4f6623981d52827778MarkupRequest: Markup language request object.
  - `callback` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8Callback, required: Clients callback where markup language is hosted.
    - `url` string, required: URL where markup language is hosted
    - `errorUrl` string: URL where errors will be sent
    - `method` 'POST' | 'GET', required: Allowed markup HTTP method.
  - `endpoint` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
    - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET'
  - `connectTimeout` integer: Time to wait, in seconds, before the called party answers the call.
  - `maxDuration` integer: Max duration of the call in seconds.
  - `from` string, required: Phone number from which the call originated from.
  - `externalId` string: Unique identifier of the call.
  - `notifyUrl` string: If set, the system will send a notification to this URL when the call ends.
  - `machineDetection` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8MachineDetection: Machine detection configuration for the dial.
    - `detectionTime` number, double: Detection time in seconds
    - `mode` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8MachineDetectionMode: Machine detection mode configuration
      - `type` 'SYNC' | 'ASYNC'
    - `messageDetection` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8MessageDetection: Message detection configuration
      - `timeout` integer: Timeout in seconds

## Response `201`

Markup Language Call Successfully Created

- Eaaf11bb9830fc826a8597df01bea6f2a14ef6d1ed129a4f6623981d52827778MarkupResponse: Markup language response object.
  - `callback` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8Callback: Clients callback where markup language is hosted.
    - `url` string, required: URL where markup language is hosted
    - `errorUrl` string: URL where errors will be sent
    - `method` 'POST' | 'GET', required: Allowed markup HTTP method.
  - `endpoint` 287f18f04e9f129a7bc94ed3ae48e2480e2673b8fdf041ab5125fde9674634b8CallEndpoint: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls.
    - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET'
  - `connectTimeout` integer: Time to wait, in seconds, before the called party answers the call.
  - `maxDuration` integer: Max duration of the call in seconds.
  - `from` string: Phone number from which the call originated from.
  - `externalId` string: Unique identifier of the call.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: 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)