---
title: "Create an action url"
method: POST
path: "/ivrs/{id}/action_urls"
tags: ["Virtual Receptionist"]
---

# Create an action url

`POST /ivrs/{id}/action_urls`

Create an action url for virtual receptionist.

## Path parameters

- `id` string, required — The unique ID of the resource.

## Request body

- object
  - `name` string — The name of action url.
  - `enabled` boolean — Enabled this event or not.
  - `type` 'DTMF' | 'CALLER' — The action url type. Can be either: - `DTMF`: - `CALLER`
  - `method` 'GET' | 'POST' — The action url request method. Can be either: - `GET` - `POST`:
  - `headers` string — The request headers of action url.
  - `caller_mask` string — The caller mask of action url.
  - `dtmf_mask` string — The DTMF mask of action url. A semicolon-separated list of DTMF number or DTMF number range. For example: 1000;2000;3000-4000.
  - `connection_timeout` integer — The connection timeout in seconds.
  - `request_timeout` integer — The request timeout in seconds.
  - `auth` 'DISABLE' | 'BASIC' | 'DIGEST' | 'BEARER' — The authentication method of event URL: Can be either: - `DISABLE`: Disable authentication. - `BASIC`: Use basic authentication. - `DIGEST`: Use digest authentication. - `BEARER`: Use bearer authentication.
  - `username` string — The username for authentication, when auth is `BASIC` or `DIGEST`.
  - `password` string — The password for authentication, when auth is `BASIC` or `DIGEST`.
  - `token` string — The token for authentication, when auth is `BEARER`.
  - `url` string — The event url.

## Response `201`

OK

- object
  - `id` string — The unique ID of the resource.

## Other responses

- `4XX` — Error

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)