---
title: "Create Forwarding Number"
method: POST
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number"
tags: ["Call Forwarding"]
---

# Create Forwarding Number

`POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/forwarding-number`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/forwarding-number/post.ts> (a function with typed inputs; its response is checked against the schema)

Adds a new forwarding number to the forwarding number list.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- CreateForwardingNumberRequest
  - `flipNumber` integer: Number assigned to the call flip phone number, corresponds to the shortcut dial number
  - `phoneNumber` string: Forwarding/Call flip phone number
  - `label` string: Forwarding/Call flip number title
  - `type` 'PhoneLine' | 'Home' | 'Mobile' | 'Work' | 'Other': Forwarding/Call flip phone type. If specified, 'label' attribute value is ignored. The default value is 'Other'
  - `device` CreateForwardingNumberDeviceInfo: Forwarding device information. Applicable for 'PhoneLine' type only. Cannot be specified together with 'phoneNumber' parameter
    - `id` string: Internal identifier of the other extension device

## Response `200`

OK

- ForwardingNumberInfo
  - `id` string: Internal identifier of a forwarding/call flip phone number
  - `uri` string, uri: Canonical URI of a forwarding/call flip phone number
  - `phoneNumber` string: Forwarding/Call flip phone number
  - `label` string: Forwarding/Call flip number title
  - `features` string[]: Type of option this phone number is used for. Multiple values are accepted
  - `flipNumber` string: Number assigned to the call flip phone number, corresponds to the shortcut dial number
  - `device` CreateForwardingNumberDeviceInfo: Forwarding device information. Applicable for 'PhoneLine' type only. Cannot be specified together with 'phoneNumber' parameter
    - `id` string: Internal identifier of the other extension device
  - `type` 'Home' | 'Mobile' | 'Work' | 'PhoneLine' | 'Outage' | 'Other' | 'BusinessMobilePhone' | 'ExternalCarrier' | 'ExtensionApps': Forwarding phone number type
  - `extension` object: Extension information. Returned only if extension type is 'ExtensionApps'
    - `id` string: Internal identifier of an extension
    - `extensionNumber` string: Number of an extension
    - `name` string: Extension name

## Other responses

- `400`: General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `404`: General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `500`: General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503`: General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)