v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
User Settings

Create Multiple User Extensions

Creates multiple user extensions with BYOD (customer provided) devices. If "extensionNumber" is not specified, the next available extension number will be assigned.

post/restapi/v2/accounts/{accountId}/batch-provisioning/users

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

Request body

Example request

{
  "records": [
    {
      "extensionNumber": "205",
      "contact": {
        "firstName": "John",
        "lastName": "Smith",
        "email": "john.smith@acme.com",
        "mobileNumber": "+16501234567"
      },
      "costCenter": {
        "id": "224149"
      },
      "roles": [
        {
          "id": "1"
        }
      ],
      "devices": [
        {
          "deviceInfo": {
            "emergency": {
              "address": {
                "street": "20 Davis Dr",
                "city": "Belmont",
                "state": "CA",
                "zip": "94002",
                "country": "US"
              }
            },
            "phoneInfo": {
              "tollType": "Toll"
            }
          }
        }
      ]
    }
  ]
}

Response

Successful response (partial success is possible)

Example response

{
  "results": [
    {
      "successful": true,
      "extension": {
        "id": "12345",
        "devices": [
          {
            "id": "12345",
            "phoneNumber": "+16501234567"
          }
        ]
      }
    }
  ]
}