---
title: "Create Scheduled Request for extension"
method: POST
path: "/v4/accounts/{voip_id}/extensions/{extension_id}/scheduled-requests"
tags: ["Scheduled Requests"]
---

# Create Scheduled Request for extension

`POST /v4/accounts/{voip_id}/extensions/{extension_id}/scheduled-requests`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/extensions/{extension_id}/scheduled-requests`
- Auth: HTTP bearer

Create scheduled request to API for extension

## Path parameters

- `voip_id` integer, required
- `extension_id` integer, required

## Request body

- ScheduledRequest
  - `request_uri` string, required: Request URI starting with "/v4". For example "/v4/accounts/12345/messages"
  - `request_method` 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', required: HTTP method of the request (GET, POST, etc.)
  - `request_body` object, nullable: Request body
  - `notification_email` string, nullable: Notification email (if not provided default account's email will be used)
  - `notification_policy` integer: Notification policy: 0 - no notifications, 1 - only if request failed, 2 - always.
  - `scheduled_at` integer, required: Request scheduled time (UNIX timestamp). Request will be performed in up to 2 minutes after that time. Up to 400 days from the API call moment.
  - `comment` string: Comment (description)
  - `tag` string, nullable: Technical identifier

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)