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

Tools

ToolDescription
dialpad_admin_accesscontrolpolicies_assignAccess Control Policies — Assign
dialpad_admin_accesscontrolpolicies_assignmentsAccess Control Policies — List Assignments
dialpad_admin_accesscontrolpolicies_createAccess Control Policies — Create
dialpad_admin_accesscontrolpolicies_deleteAccess Control Policies — Delete
dialpad_admin_accesscontrolpolicies_getAccess Control Policies — Get
dialpad_admin_accesscontrolpolicies_listAccess Control Policies — List Policies
dialpad_admin_accesscontrolpolicies_unassignAccess Control Policies — Unassign
dialpad_admin_accesscontrolpolicies_updateAccess Control Policies — Update
dialpad_admin_app_settings_getApp Settings — Get
dialpad_admin_blockednumbers_addBlocked Number — Add
dialpad_admin_blockednumbers_getBlocked Number — Get
dialpad_admin_blockednumbers_listBlocked Numbers — List
dialpad_admin_blockednumbers_removeBlocked Number — Remove
dialpad_admin_format_postPhone String — Reformat
dialpad_admin_numbers_assign_number_postDialpad Number — Assign
dialpad_admin_numbers_assign_target_number_postDialpad Number — Auto-Assign
dialpad_admin_numbers_deleteDialpad Number — Unassign
dialpad_admin_numbers_getDialpad Number — Get
dialpad_admin_numbers_listDialpad Number — List
dialpad_admin_numbers_swap_number_postDialpad Number — Swap
dialpad_admin_schedule_reports_createschedule reports — Create
dialpad_admin_schedule_reports_deleteSchedule reports — Delete
dialpad_admin_schedule_reports_getSchedule reports — Get
dialpad_admin_schedule_reports_listSchedule reports — List
dialpad_admin_schedule_reports_updateSchedule reports — Update
dialpad_admin_stats_createStats — Initiate Processing
dialpad_admin_stats_getStats — Get Result
dialpad_admin_tags_patchNumber Tags — Update tags for a phone number.
dialpad_admin_webhook_updateWebhook — Update
dialpad_admin_webhooks_createWebhook — Create
dialpad_admin_webhooks_deleteWebhook — Delete
dialpad_admin_webhooks_getWebhook — Get
dialpad_admin_webhooks_listWebhook — List
dialpad_admin_websockets_createWebsocket — Create
dialpad_admin_websockets_deleteWebsocket — Delete
dialpad_admin_websockets_getWebsocket — Get
dialpad_admin_websockets_listWebsocket — List
dialpad_admin_websockets_updateWebsocket — Update

dialpad_admin_accesscontrolpolicies_assign

Access Control Policies — Assign Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe access control policy’s id.
target_idintegerNoRequired if the policy is associated with a target (Office or Contact Center). Not required for a company level policy.
target_typestringNoPolicy permissions applied at this target level. Defaults to company target type.
user_idintegerYesThe user’s id to be assigned to the policy.

dialpad_admin_accesscontrolpolicies_assignments

Access Control Policies — List Assignments Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
idintegerYesThe access control policy’s id.

dialpad_admin_accesscontrolpolicies_create

Access Control Policies — Create Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNo[single-line only] Optional description for the policy. Max 200 characters.
namestringYes[single-line only] A human-readable display name for the policy. Max 50 characters.
owner_idintegerYesOwner for this policy i.e company admin.
permission_setsstring[]YesList of permissions associated with this policy.
target_typestringNoPolicy permissions applied at this target level. Defaults to company target type.

dialpad_admin_accesscontrolpolicies_delete

Access Control Policies — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe access control policy’s id.

dialpad_admin_accesscontrolpolicies_get

Access Control Policies — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe access control policy’s id.

dialpad_admin_accesscontrolpolicies_list

Access Control Policies — List Policies Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.

dialpad_admin_accesscontrolpolicies_unassign

Access Control Policies — Unassign Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe access control policy’s id.
target_idintegerNoRequired if the policy is associated with a target (Office or Contact Center). Not required for a company level policy or if unassign_all is True.
target_typestringNoPolicy permissions applied at this target level. Defaults to company target type.
unassign_allbooleanNoUnassign all associated target groups from the user for a policy.
user_idintegerYesThe user’s id to be unassigned from the policy.

dialpad_admin_accesscontrolpolicies_update

Access Control Policies — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe access control policy’s id.
descriptionstringNo[single-line only] Optional description for the policy.
namestringNo[single-line only] A human-readable display name for the policy.
permission_setsstring[]NoList of permissions associated with this policy.
statestringNoRestore a deleted policy.
user_idintegerNouser id updating this policy. Must be a company admin

dialpad_admin_app_settings_get

App Settings — Get Parameters:
ParameterTypeRequiredDefaultDescription
target_idintegerNoThe target’s id.
target_typestringNoThe target’s type.

dialpad_admin_blockednumbers_add

Blocked Number — Add Parameters:
ParameterTypeRequiredDefaultDescription
numbersstring[]NoA list of E164 formatted numbers.

dialpad_admin_blockednumbers_get

Blocked Number — Get Parameters:
ParameterTypeRequiredDefaultDescription
numberstringYesA phone number (e164 format).

dialpad_admin_blockednumbers_list

Blocked Numbers — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.

dialpad_admin_blockednumbers_remove

Blocked Number — Remove Parameters:
ParameterTypeRequiredDefaultDescription
numbersstring[]NoA list of E164 formatted numbers.

dialpad_admin_format_post

Phone String — Reformat Parameters:
ParameterTypeRequiredDefaultDescription
country_codestringNoCountry code in ISO 3166-1 alpha-2 format such as “US”. Required when sending local formatted phone number
numberstringNoPhone number in local or E.164 format

dialpad_admin_numbers_assign_number_post

Dialpad Number — Assign Parameters:
ParameterTypeRequiredDefaultDescription
numberstringYesA specific number to assign
primarybooleanNoA boolean indicating whether this should become the target’s primary phone number.
target_idintegerYesThe ID of the target to reassign this number to.
target_typestringYesThe type of the target.

dialpad_admin_numbers_assign_target_number_post

Dialpad Number — Auto-Assign Parameters:
ParameterTypeRequiredDefaultDescription
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 target’s primary phone number.
target_idintegerYesThe ID of the target to reassign this number to.
target_typestringYesThe type of the target.

dialpad_admin_numbers_delete

Dialpad Number — Unassign Parameters:
ParameterTypeRequiredDefaultDescription
numberstringYesA phone number (e164 format).
releasebooleanNoReleases the number (does not return it to the company reserved pool).

dialpad_admin_numbers_get

Dialpad Number — Get Parameters:
ParameterTypeRequiredDefaultDescription
numberstringYesA phone number (e164 format).

dialpad_admin_numbers_list

Dialpad Number — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.
statusstringNoStatus to filter by.

dialpad_admin_numbers_swap_number_post

Dialpad Number — Swap Parameters:
ParameterTypeRequiredDefaultDescription
swap_detailsobjectNoType of number swap (area_code, auto, provided_number).
targetobjectYesThe target value

dialpad_admin_schedule_reports_create

schedule reports — Create Parameters:
ParameterTypeRequiredDefaultDescription
atintegerYesHour of the day when the report will execute considering the frequency and timezones between 0 and 23 e.g. 10 will be 10:00 am.
coaching_groupbooleanNoWhether the statistics should be for trainees of the coach group with the given target_id.
enabledbooleanNoWhether or not this schedule reports event subscription is enabled.
endpoint_idintegerYesThe logging endpoint’s ID, which is generated after creating a webhook or websocket successfully.
frequencystringYesHow often the report will execute.
namestringYes[single-line only] The name of the schedule reports.
on_dayintegerYesThe day of the week or month when the report will execute considering the frequency. daily=0, weekly=0-6, monthly=0-30.
report_typestringYesThe type of report that will be generated.
target_idintegerNoThe target’s id.
target_typestringNoTarget’s type.
timezonestringNoTimezone using a tz database name.

dialpad_admin_schedule_reports_delete

Schedule reports — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe schedule reports subscription’s ID.

dialpad_admin_schedule_reports_get

Schedule reports — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe schedule reports subscription’s ID.

dialpad_admin_schedule_reports_list

Schedule reports — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.

dialpad_admin_schedule_reports_update

Schedule reports — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe schedule reports subscription’s ID.
atintegerYesHour of the day when the report will execute considering the frequency and timezones between 0 and 23 e.g. 10 will be 10:00 am.
coaching_groupbooleanNoWhether the statistics should be for trainees of the coach group with the given target_id.
enabledbooleanNoWhether or not this schedule reports event subscription is enabled.
endpoint_idintegerYesThe logging endpoint’s ID, which is generated after creating a webhook or websocket successfully.
frequencystringYesHow often the report will execute.
namestringYes[single-line only] The name of the schedule reports.
on_dayintegerYesThe day of the week or month when the report will execute considering the frequency. daily=0, weekly=0-6, monthly=0-30.
report_typestringYesThe type of report that will be generated.
target_idintegerNoThe target’s id.
target_typestringNoTarget’s type.
timezonestringNoTimezone using a tz database name.

dialpad_admin_stats_create

Stats — Initiate Processing Parameters:
ParameterTypeRequiredDefaultDescription
coaching_groupbooleanNoWhether or not the statistics should be for trainees of the coach group with the given target_id.
coaching_teambooleanNoWhether or not the statistics should be for trainees of the coach team with the given target_id.
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.
export_typestringYesWhether to return aggregated statistics (stats), or individual rows for each record (records). NOTE: For stat_type “csat” or “dispositions”, only “records” is supported.
group_bystringNoThis param is only applicable when the stat_type is specified as call. For call stats, group calls by user per day (default), get total metrics by day, or break down by department and call center (office only).
is_todaybooleanNoWhether or not the statistics are for the current day. NOTE: days_ago_start and days_ago_end are ignored if this is passed in.
office_idintegerNoID of the office to get statistics for. If a target_id and target_type are passed in this value is ignored and instead the target is used.
stat_typestringYesThe type of statistics to be returned. NOTE: if the value is “csat” or “dispositions”, target_id and target_type must be specified.
target_idintegerNoThe target’s id.
target_typestringNoTarget’s type.
timezonestringNoTimezone using a tz database name.

dialpad_admin_stats_get

Stats — Get Result Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesRequest ID returned by a POST /stats request.

dialpad_admin_tags_patch

Number Tags — Update tags for a phone number. Parameters:
ParameterTypeRequiredDefaultDescription
do_not_callbooleanNoWhether calls should be blocked for this number.
do_not_textbooleanNoWhether texts should be blocked for this number.
phonestringYesThe phone number in E.164 format (e.g., “+14155551234”).

dialpad_admin_webhook_update

Webhook — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe webhook’s ID, which is generated after creating a webhook successfully.
hook_urlstringNoThe webhook’s URL. Triggered events will be sent to the url provided here.
secretstringNo[single-line only] Webhook’s signature secret that’s used to confirm the validity of the request.

dialpad_admin_webhooks_create

Webhook — Create Parameters:
ParameterTypeRequiredDefaultDescription
hook_urlstringYesThe webhook’s URL. Triggered events will be sent to the url provided here.
secretstringNo[single-line only] Webhook’s signature secret that’s used to confirm the validity of the request.

dialpad_admin_webhooks_delete

Webhook — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe webhook’s ID, which is generated after creating a webhook successfully.

dialpad_admin_webhooks_get

Webhook — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe webhook’s ID, which is generated after creating a webhook successfully.

dialpad_admin_webhooks_list

Webhook — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.

dialpad_admin_websockets_create

Websocket — Create Parameters:
ParameterTypeRequiredDefaultDescription
secretstringNo[single-line only] Websocket’s signature secret that’s used to confirm the validity of the request.

dialpad_admin_websockets_delete

Websocket — Delete Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe websocket’s ID, which is generated after creating a websocket successfully.

dialpad_admin_websockets_get

Websocket — Get Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe websocket’s ID, which is generated after creating a websocket successfully.

dialpad_admin_websockets_list

Websocket — List Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoA token used to return the next page of a previous request. Use the cursor provided in the previous response.

dialpad_admin_websockets_update

Websocket — Update Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe websocket’s ID, which is generated after creating a websocket successfully.
secretstringNo[single-line only] Websocket’s signature secret that’s used to confirm the validity of the request.