Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Call Handling Rules

Create Company Call Handling Rule

Creates call handling rule on account level.

post/restapi/v1.0/account/{accountId}/answering-rule

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

namestring

Name of an answering rule specified by user. Max number of symbols is 30. The default value is 'My Rule N' where 'N' is the first free number

enabledboolean

Specifies if the rule is active or inactive. The default value is true

type'BusinessHours' | 'AfterHours' | 'Custom'

Type of an answering rule, the default value is 'Custom' = ['BusinessHours', 'AfterHours', 'Custom']

callHandlingAction'Operator' | 'Disconnect' | 'Bypass'

Specifies how incoming calls are forwarded. The default value is 'Operator' 'Operator' - play company greeting and forward to operator extension 'Disconnect' - play company greeting and disconnect 'Bypass' - bypass greeting to go to selected extension = ['Operator', 'Disconnect', 'Bypass']

Response

OK

idstring

Internal identifier of an answering rule

uristring uri

Canonical URI of an answering rule

enabledboolean

Specifies if the rule is active or inactive

type'BusinessHours' | 'AfterHours' | 'Custom'

Type of an answering rule

namestring

Name of an answering rule specified by user. Max number of symbols is 30. The default value is 'My Rule N' where 'N' is the first free number

callHandlingAction'Operator' | 'Disconnect' | 'Bypass'

Specifies how incoming calls are forwarded. The default value is 'Operator' 'Operator' - play company greeting and forward to operator extension 'Disconnect' - play company greeting and disconnect 'Bypass' - bypass greeting to go to selected extension = ['Operator', 'Disconnect', 'Bypass']