Add an Alarm

Add an alarm for a specific extension.

Note:
  • Add one alarm for one extension at a time. If you add multiple alarms at a time, only the newly added alarm will take effect.
  • A maximum of 23 alarms can be added for an extension.

Request URL

POST {base_url}/{api_path}/wakeupcall/create?access_token={access_token}

Request parameters

Table 1.
Parameter Required Type Description
ext_id Yes Integer The unique ID of an extension.
Note: You can query extension's ID using Search Specific Extensions.
alarm_time Yes String

The alarm time in 24-hour clock format. For example: 07:30.

repeat_type No String How often will the alarm be repeated.
Valid value:
  • never (default)
  • every_monday
  • every_tuesday
  • every_wednesday
  • every_thursday
  • every_friday
  • every_saturday
  • every_sunday
Note:
  • Use a comma to separate multiple types.
  • If repeat_type is set to never, PBX will delete the alarm after the alarm has been repeated for the designated repeat times.
number_of_snoozes No Integer How many times will the alarm be repeated.
Valid value:
  • 0 (default)
  • 1
  • 2
  • 3
snooze_duration No Integer The interval in minutes between each repeat.

Default value: 10

alarm_prompt No String The name of alarm prompt.
Note:
  • If you don't set the parameter, the system will play the Music on Hold (MoH).
  • This must be a custom prompt. You can obtain the custom prompt name on PBX web portal (Path: PBX Settings > Voice Prompt > Custom Prompt).

Response parameters

Table 2.
Parameter Type Description
errcode Integer Returned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsg String Returned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
id Integer The unique ID of the alarm.

Examples

Request example

POST /openapi/v1.0/wakeupcall/create?access_token=ojPrvnfzPdwc8OCcRmhG16gEHuZcwFco HTTP/1.1
Host: 192.168.5.150:8088
Content-Type: application/json
{
    "ext_id":39,
    "alarm_time":"07:00",
    "repeat_type":"every_monday,every_tuesday,every_wednesday,every_thursday,every_friday",
    "number_of_snoozes":3,
    "snooze_duration":5,
    "alarm_prompt":"alarm_prompt"
}

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "id": 12
}