Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Automatic Location Updates

Create User Emergency Location

Creates a personal emergency response location for the current user.

post/restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations

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)

extensionIdstring required

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

Request body

namestring

Name of a new personal emergency response location

addressFormatIdstring

Address format ID

trustedboolean

If 'true' address validation for non-us addresses is skipped

Response

Emergency location information

idstring

Internal identifier of an emergency response location

namestring

Emergency response location name

addressStatus'Valid' | 'Invalid' | 'Provisioning'

Emergency address status

usageStatus'Active' | 'Inactive'

Status of emergency response location usage.

syncStatus'Verified' | 'Updated' | 'Deleted' | 'ActivationProcess' | 'NotRequired' | 'Unsupported' | 'Failed'

Resulting status of emergency address synchronization. Returned if syncEmergencyAddress parameter is set to true

addressType'LocationWithElins' | 'LocationWithEndpoint'
visibility'Private' | 'Public'

Visibility of an emergency response location. If Private is set, then location is visible only for the restricted number of users, specified in owners array

addressFormatIdstring

Address format ID

trustedboolean

If 'true' address validation for non-us addresses is skipped