Skip to main content
Server path: /dialpad-contact-center | Type: Application | PCID required: Yes

Tools

ToolDescription
dialpad_contact_center_callcenters_createCall Centers — Create
dialpad_contact_center_callcenters_deleteCall Centers — Delete
dialpad_contact_center_callcenters_getCall Centers — Get
dialpad_contact_center_callcenters_listallCall Centers — List
dialpad_contact_center_callcenters_operators_deleteOperator — Remove
dialpad_contact_center_callcenters_operators_dutystatusOperator — Update Duty Status
dialpad_contact_center_callcenters_operators_getOperators — List
dialpad_contact_center_callcenters_operators_get_dutystatusOperator — Get Duty Status
dialpad_contact_center_callcenters_operators_get_skilllevelOperator — Get Skill Level
dialpad_contact_center_callcenters_operators_postOperator — Add
dialpad_contact_center_callcenters_operators_skilllevelOperator — Update Skill Level
dialpad_contact_center_callcenters_statusCall Centers — Status
dialpad_contact_center_callcenters_updateCall Centers — Update
dialpad_contact_center_callrouters_createCall Router — Create
dialpad_contact_center_callrouters_deleteCall Router — Delete
dialpad_contact_center_callrouters_getCall Router — Get
dialpad_contact_center_callrouters_listCall Router — List
dialpad_contact_center_callrouters_updateCall Router — Update
dialpad_contact_center_custom_ivrs_getCustom IVR — Get
dialpad_contact_center_dispositions_createDispositions — Create
dialpad_contact_center_dispositions_deleteDispositions — Delete
dialpad_contact_center_dispositions_getDispositions — Get
dialpad_contact_center_dispositions_listDispositions — List
dialpad_contact_center_dispositions_updateDispositions — Update
dialpad_contact_center_ivr_createCustom IVR — Create
dialpad_contact_center_ivr_deleteCustom IVR — Delete
dialpad_contact_center_ivr_details_updateCustom IVR — Update
dialpad_contact_center_ivr_updateCustom IVR — Assign
dialpad_contact_center_numbers_assign_call_router_number_postDialpad Number — Assign
dialpad_contact_center_scorecards_export_createScorecards export — Initiate Processing
dialpad_contact_center_scorecards_export_getScorecards export — Get Result
dialpad_contact_center_scorecards_getScorecards — Get
dialpad_contact_center_scorecards_listScorecards — List
dialpad_contact_center_wfm_metrics_activity_getActivity Metrics
dialpad_contact_center_wfm_metrics_agent_getAgent Metrics

dialpad_contact_center_callcenters_create

Call Centers — Create Parameters:
ParameterTypeRequiredDefaultDescription
advanced_settingsobjectNoAdvanced Settings
alertsobjectNoThe alerts value
friday_hoursstring[]NoThe Friday hours of operation. Default value is [“08:00”, “18:00”].
group_descriptionstringNoThe description of the call center. Max 256 characters.
hold_queueobjectNoHold Queue
hours_onbooleanNoThe time frame when the call center wants to receive calls. Default value is false, which means the call center will always take calls (24/7).
monday_hoursstring[]NoThe Monday hours of operation. To specify when hours_on is set to True. e.g. [“08:00”, “12:00”, “14:00”, “18:00”] => open from 8AM to Noon, and from 2PM to 6PM. Default value is [“08:00”, “18:00”].
namestringYes[single-line only] The name of the call center. Max 100 characters.
office_idintegerYesThe id of the office to which the call center belongs..
ring_secondsintegerNoThe number of seconds to allow the group line to ring before going to voicemail. Choose from 10 seconds to 45 seconds. Default is 30 seconds.
routing_optionsobjectNoRouting Options
saturday_hoursstring[]NoThe Saturday hours of operation. Default is empty array.
sunday_hoursstring[]NoThe Sunday hours of operation. Default is empty array.
thursday_hoursstring[]NoThe Thursday hours of operation. Default value is [“08:00”, “18:00”].
tuesday_hoursstring[]NoThe Tuesday hours of operation. Default value is [“08:00”, “18:00”].
voice_intelligenceobjectNoVoice Intelligence
wednesday_hoursstring[]NoThe Wednesday hours of operation. Default value is [“08:00”, “18:00”].

dialpad_contact_center_callcenters_delete

Call Centers — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.

dialpad_contact_center_callcenters_get

Call Centers — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.

dialpad_contact_center_callcenters_listall

Call Centers — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
office_idintegerNosearch call center by office.
name_searchstringNosearch call centers by name or search by the substring of the name. If input example is ‘Cool’, output example can be a list of call centers whose name contains the string ‘Cool’ - [‘Cool call center 1’, ‘Cool call center 2049’]

dialpad_contact_center_callcenters_operators_delete

Operator — Remove Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.
user_idintegerYesID of the operator to remove.

dialpad_contact_center_callcenters_operators_dutystatus

Operator — Update Duty Status Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe operator’s user id.
duty_status_reasonstringNo[single-line only] A description of this status.
on_dutybooleanYesTrue if this status message indicates an “on-duty” status.

dialpad_contact_center_callcenters_operators_get

Operators — List Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.

dialpad_contact_center_callcenters_operators_get_dutystatus

Operator — Get Duty Status Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe operator’s user id.

dialpad_contact_center_callcenters_operators_get_skilllevel

Operator — Get Skill Level Parameters:
ParameterTypeRequiredDefaultDescription
call_center_idintegerYesThe call center’s ID
user_idintegerYesThe operator’s ID

dialpad_contact_center_callcenters_operators_post

Operator — Add Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.
keep_paid_numbersbooleanNoWhether or not to keep phone numbers when switching to a support license. Note: Phone numbers require additional number licenses under a support license.
license_typestringNoThe type of license to assign to the new operator if a license is required. (agents or lite_support_agents). Defaults to agents
rolestringNoThe role the user should assume.
skill_levelintegerNoSkill level of the operator. Integer value in range 1 - 100. Default 100.
user_idintegerYesThe ID of the user.

dialpad_contact_center_callcenters_operators_skilllevel

Operator — Update Skill Level Parameters:
ParameterTypeRequiredDefaultDescription
call_center_idintegerYesThe call center’s ID
user_idintegerYesThe operator’s ID
skill_levelintegerYesNew skill level to set the operator in the call center. It must be an integer value between 0 and 100.

dialpad_contact_center_callcenters_status

Call Centers — Status Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.

dialpad_contact_center_callcenters_update

Call Centers — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe call center’s id.
advanced_settingsobjectNoAdvanced Settings
alertsobjectNoThe alerts value
friday_hoursstring[]NoThe Friday hours of operation. Default value is [“08:00”, “18:00”].
group_descriptionstringNoThe description of the call center. Max 256 characters.
hold_queueobjectNoHold Queue
hours_onbooleanNoThe time frame when the call center wants to receive calls. Default value is false, which means the call center will always take calls (24/7).
monday_hoursstring[]NoThe Monday hours of operation. To specify when hours_on is set to True. e.g. [“08:00”, “12:00”, “14:00”, “18:00”] => open from 8AM to Noon, and from 2PM to 6PM. Default value is [“08:00”, “18:00”].
namestringNo[single-line only] The name of the call center. Max 100 characters.
ring_secondsintegerNoThe number of seconds to allow the group line to ring before going to voicemail. Choose from 10 seconds to 45 seconds. Default is 30 seconds.
routing_optionsobjectNoRouting Options
saturday_hoursstring[]NoThe Saturday hours of operation. Default is empty array.
sunday_hoursstring[]NoThe Sunday hours of operation. Default is empty array.
thursday_hoursstring[]NoThe Thursday hours of operation. Default value is [“08:00”, “18:00”].
tuesday_hoursstring[]NoThe Tuesday hours of operation. Default value is [“08:00”, “18:00”].
voice_intelligenceobjectNoVoice Intelligence
wednesday_hoursstring[]NoThe Wednesday hours of operation. Default value is [“08:00”, “18:00”].

dialpad_contact_center_callrouters_create

Call Router — Create Parameters:
ParameterTypeRequiredDefaultDescription
default_target_idintegerYesThe ID of the target that should be used as a fallback destination for calls if the call router is disabled or fails.
default_target_typestringYesThe entity type of the default target.
enabledbooleanNoIf set to False, the call router will skip the routing url and instead forward calls straight to the default target.
namestringYes[single-line only] A human-readable display name for the router.
office_idintegerYesThe ID of the office to which this router belongs.
routing_urlstringYesThe URL that should be used to drive call routing decisions.
secretstringNo[single-line only] The call router’s signature secret. This is a plain text string that you should generate with a minimum length of 32 characters.

dialpad_contact_center_callrouters_delete

Call Router — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe API call router’s ID

dialpad_contact_center_callrouters_get

Call Router — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe API call router’s ID

dialpad_contact_center_callrouters_list

Call Router — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
office_idintegerNoThe office’s id.

dialpad_contact_center_callrouters_update

Call Router — Update Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe API call router’s ID
default_target_idintegerNoThe ID of the target that should be used as a fallback destination for calls if the call router is disabled or fails.
default_target_typestringNoThe entity type of the default target.
enabledbooleanNoIf set to False, the call router will skip the routing url and instead forward calls straight to the default target.
namestringNo[single-line only] A human-readable display name for the router.
office_idintegerNoThe ID of the office to which this router belongs.
reset_error_countbooleanNoSets the auto-disablement routing error count back to zero. Call routers maintain a count of the number of errors that have occurred within the past hour, and automatically become disabled when that count exceeds 10. Setting enabled to true via the API will not reset that count, which means that the router will likely become disabled again after one more error. In most cases, this will be useful for testing fixes in your routing API, but in some circumstances it may be desirable to reset that counter.
routing_urlstringNoThe URL that should be used to drive call routing decisions.
secretstringNo[single-line only] The call router’s signature secret. This is a plain text string that you should generate with a minimum length of 32 characters.

dialpad_contact_center_custom_ivrs_get

Custom IVR — Get Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
target_typestringYesTarget’s type.
target_idintegerYesThe target’s id.

dialpad_contact_center_dispositions_create

Dispositions — Create Parameters:
ParameterTypeRequiredDefaultDescription
dispositionsobjectNoThe dispositions.
namestringYes[single-line only] The name of the parent disposition.
office_idintegerYesThe ID of the office assigned to the dispositions.

dialpad_contact_center_dispositions_delete

Dispositions — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id of the dispositions.

dialpad_contact_center_dispositions_get

Dispositions — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe disposition’s id.

dialpad_contact_center_dispositions_list

Dispositions — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
target_idintegerNoThe target’s id.
target_typestringNoThe target’s type.

dialpad_contact_center_dispositions_update

Dispositions — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id of the dispositions.
actionstringNoThe action will determine whether to add or remove the specified target from the dispositions.
dispositionsobjectNoThe dispositions.
namestringNo[single-line only] The name of the parent disposition.
target_idintegerNoThe target id for the dispositions.
target_typestringNoThe target type for the dispositions.

dialpad_contact_center_ivr_create

Custom IVR — Create Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNo[single-line only] The description of the new IVR. Max 256 characters.
filestringYesAn MP3 audio file. The file needs to be Base64-encoded.
ivr_typestringYesType of IVR.
namestringNo[single-line only] The name of the new IVR. Max 100 characters.
target_idintegerYesThe ID of the target to which you want to assign this IVR.
target_typestringYesThe type of the target to which you want to assign this IVR.

dialpad_contact_center_ivr_delete

Custom IVR — Delete Parameters:
ParameterTypeRequiredDefaultDescription
target_typestringYesTarget’s type of the custom ivr to be updated.
target_idintegerYesThe id of the target.
ivr_typestringYesType of ivr you want to update.
ivr_idintegerYesThe id of the ivr that you want to use for the ivr type.
select_optionstringNoFor call center auto call recording only. Set ivr for inbound or outbound. Default is both.

dialpad_contact_center_ivr_details_update

Custom IVR — Update Parameters:
ParameterTypeRequiredDefaultDescription
ivr_idstringYesThe ID of the custom ivr to be updated.
descriptionstringNo[single-line only] The description of the IVR.
namestringNo[single-line only] The name of this IVR.

dialpad_contact_center_ivr_update

Custom IVR — Assign Parameters:
ParameterTypeRequiredDefaultDescription
target_typestringYesTarget’s type.
target_idintegerYesThe target’s id.
ivr_typestringYesType of ivr you want to update
ivr_idintegerYesThe id of the ivr that you want to use for the ivr type.
select_optionstringNoFor call center auto call recording only. Set ivr for inbound or outbound. Default is both.

dialpad_contact_center_numbers_assign_call_router_number_post

Dialpad Number — Assign Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe API call router’s ID
area_codestringNoAn area code in which to find an available phone number for assignment.
numberstringNoA phone number to assign. (e164-formatted)
primarybooleanNoA boolean indicating whether this should become the primary phone number.

dialpad_contact_center_scorecards_export_create

Scorecards export — Initiate Processing Parameters:
ParameterTypeRequiredDefaultDescription
days_ago_endintegerNoEnd of the date range to get statistics for. This is the number of days to look back relative to the current day. Used in conjunction with days_ago_start to specify a range.
days_ago_startintegerNoStart of the date range to get statistics for. This is the number of days to look back relative to the current day. Used in conjunction with days_ago_end to specify a range.
graded_days_ago_endintegerNoEnd of the graded date range to get statistics for. This is the number of days to look back relative to the current day. Used in conjunction with graded_days_ago_start to specify a range.
graded_days_ago_startintegerNoStart of the graded date range to get statistics for. This is the number of days to look back relative to the current day. Used in conjunction with graded_days_ago_end to specify a range.
scorecard_grader_idintegerNoThe scorecard grader’s id.
scorecard_idsinteger[]NoThe scorecard ids.
scorecards_typestringYesThe type of scorecards statistics to be returned.
send_tostringNoThe email to send the results to.
target_idintegerNoThe target’s id.
target_typestringNoThe target’s type.
timezonestringNoTimezone using a tz database name.

dialpad_contact_center_scorecards_export_get

Scorecards export — Get Result Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesRequest ID returned by a POST /scorecards/export request.

dialpad_contact_center_scorecards_get

Scorecards — Get Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe scorecard’s id.

dialpad_contact_center_scorecards_list

Scorecards — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
statestringNoThe scorecard’s state.
target_idintegerNoThe target’s id.
target_typestringNoThe target’s type.

dialpad_contact_center_wfm_metrics_activity_get

Activity Metrics Parameters:
ParameterTypeRequiredDefaultDescription
idsstringNo(optional) Comma-separated Dialpad user IDs of agents
emailsstringNo(optional) Comma-separated email addresses of agents
cursorstringNoInclude the cursor returned in a previous request to get the next page of data
endstringYesUTC ISO 8601 timestamp (exclusive, e.g., 2025-02-23T00:00:00Z)
startstringYesUTC ISO 8601 timestamp (inclusive, e.g., 2025-02-17T00:00:00Z)

dialpad_contact_center_wfm_metrics_agent_get

Agent Metrics Parameters:
ParameterTypeRequiredDefaultDescription
idsstringNo(optional) Comma-separated Dialpad user IDs of agents
emailsstringNo(optional) Comma-separated email addresses of agents
cursorstringNoInclude the cursor returned in a previous request to get the next page of data
endstringYesUTC ISO 8601 timestamp (exclusive, e.g., 2025-02-23T00:00:00Z)
startstringYesUTC ISO 8601 timestamp (inclusive, e.g., 2025-02-17T00:00:00Z)