---
title: "Create Order"
method: POST
path: "/v4/accounts/{voip_id}/orders"
tags: ["Orders"]
---

# Create Order

`POST /v4/accounts/{voip_id}/orders`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/orders`
- Auth: HTTP bearer

Order new physical devices. Contact out support to get access to this API.

## Path parameters

- `voip_id` integer, required

## Request body

- Order
  - `contact_id` integer, required: ID of the contact where devices should be delivered to
  - `payment_method_id` integer, nullable: Payment method ID
  - `shipping_method` 'FEDEXGROUND' | '3DAY' | '2DAY' | 'STANDARDOVERNIGHT' | 'PRIORITYOVERNIGHT' | 'OVERNIGHTEARLYAM', nullable: Shipping method. One of: FEDEXGROUND, 3DAY, 2DAY, STANDARDOVERNIGHT, PRIORITYOVERNIGHT, OVERNIGHTEARLYAM. Use Shipping Methods API to get more data.
  - `devices` object[], nullable: Device for purchasing
    - `name` string, nullable: Optional name of the devices (how it should appear on your account)
    - `code` integer, required: Code of the device
  - `accessories` object[], nullable: List of accessories to order
    - `code` integer, required: Codes of accessories

## 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/b4762877b9e7?raw)