/dialpad-admin | Type: Application | PCID required: Yes
Tools
dialpad_admin_accesscontrolpolicies_assign
Access Control Policies — Assign Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The access control policy’s id. |
target_id | integer | No | — | Required if the policy is associated with a target (Office or Contact Center). Not required for a company level policy. |
target_type | string | No | — | Policy permissions applied at this target level. Defaults to company target type. |
user_id | integer | Yes | — | The user’s id to be assigned to the policy. |
dialpad_admin_accesscontrolpolicies_assignments
Access Control Policies — List Assignments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A token used to return the next page of a previous request. Use the cursor provided in the previous response. |
id | integer | Yes | — | The access control policy’s id. |
dialpad_admin_accesscontrolpolicies_create
Access Control Policies — Create Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | No | — | [single-line only] Optional description for the policy. Max 200 characters. |
name | string | Yes | — | [single-line only] A human-readable display name for the policy. Max 50 characters. |
owner_id | integer | Yes | — | Owner for this policy i.e company admin. |
permission_sets | string[] | Yes | — | List of permissions associated with this policy. |
target_type | string | No | — | Policy permissions applied at this target level. Defaults to company target type. |
dialpad_admin_accesscontrolpolicies_delete
Access Control Policies — Delete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The access control policy’s id. |
dialpad_admin_accesscontrolpolicies_get
Access Control Policies — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The access control policy’s id. |
dialpad_admin_accesscontrolpolicies_list
Access Control Policies — List Policies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The access control policy’s id. |
target_id | integer | No | — | Required 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_type | string | No | — | Policy permissions applied at this target level. Defaults to company target type. |
unassign_all | boolean | No | — | Unassign all associated target groups from the user for a policy. |
user_id | integer | Yes | — | The user’s id to be unassigned from the policy. |
dialpad_admin_accesscontrolpolicies_update
Access Control Policies — Update Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The access control policy’s id. |
description | string | No | — | [single-line only] Optional description for the policy. |
name | string | No | — | [single-line only] A human-readable display name for the policy. |
permission_sets | string[] | No | — | List of permissions associated with this policy. |
state | string | No | — | Restore a deleted policy. |
user_id | integer | No | — | user id updating this policy. Must be a company admin |
dialpad_admin_app_settings_get
App Settings — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target_id | integer | No | — | The target’s id. |
target_type | string | No | — | The target’s type. |
dialpad_admin_blockednumbers_add
Blocked Number — Add Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
numbers | string[] | No | — | A list of E164 formatted numbers. |
dialpad_admin_blockednumbers_get
Blocked Number — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
number | string | Yes | — | A phone number (e164 format). |
dialpad_admin_blockednumbers_list
Blocked Numbers — List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
numbers | string[] | No | — | A list of E164 formatted numbers. |
dialpad_admin_format_post
Phone String — Reformat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
country_code | string | No | — | Country code in ISO 3166-1 alpha-2 format such as “US”. Required when sending local formatted phone number |
number | string | No | — | Phone number in local or E.164 format |
dialpad_admin_numbers_assign_number_post
Dialpad Number — Assign Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
number | string | Yes | — | A specific number to assign |
primary | boolean | No | — | A boolean indicating whether this should become the target’s primary phone number. |
target_id | integer | Yes | — | The ID of the target to reassign this number to. |
target_type | string | Yes | — | The type of the target. |
dialpad_admin_numbers_assign_target_number_post
Dialpad Number — Auto-Assign Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
area_code | string | No | — | An area code in which to find an available phone number for assignment. |
number | string | No | — | A phone number to assign. (e164-formatted) |
primary | boolean | No | — | A boolean indicating whether this should become the target’s primary phone number. |
target_id | integer | Yes | — | The ID of the target to reassign this number to. |
target_type | string | Yes | — | The type of the target. |
dialpad_admin_numbers_delete
Dialpad Number — Unassign Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
number | string | Yes | — | A phone number (e164 format). |
release | boolean | No | — | Releases the number (does not return it to the company reserved pool). |
dialpad_admin_numbers_get
Dialpad Number — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
number | string | Yes | — | A phone number (e164 format). |
dialpad_admin_numbers_list
Dialpad Number — List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A token used to return the next page of a previous request. Use the cursor provided in the previous response. |
status | string | No | — | Status to filter by. |
dialpad_admin_numbers_swap_number_post
Dialpad Number — Swap Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
swap_details | object | No | — | Type of number swap (area_code, auto, provided_number). |
target | object | Yes | — | The target value |
dialpad_admin_schedule_reports_create
schedule reports — Create Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
at | integer | Yes | — | Hour 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_group | boolean | No | — | Whether the statistics should be for trainees of the coach group with the given target_id. |
enabled | boolean | No | — | Whether or not this schedule reports event subscription is enabled. |
endpoint_id | integer | Yes | — | The logging endpoint’s ID, which is generated after creating a webhook or websocket successfully. |
frequency | string | Yes | — | How often the report will execute. |
name | string | Yes | — | [single-line only] The name of the schedule reports. |
on_day | integer | Yes | — | The day of the week or month when the report will execute considering the frequency. daily=0, weekly=0-6, monthly=0-30. |
report_type | string | Yes | — | The type of report that will be generated. |
target_id | integer | No | — | The target’s id. |
target_type | string | No | — | Target’s type. |
timezone | string | No | — | Timezone using a tz database name. |
dialpad_admin_schedule_reports_delete
Schedule reports — Delete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The schedule reports subscription’s ID. |
dialpad_admin_schedule_reports_get
Schedule reports — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The schedule reports subscription’s ID. |
dialpad_admin_schedule_reports_list
Schedule reports — List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The schedule reports subscription’s ID. |
at | integer | Yes | — | Hour 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_group | boolean | No | — | Whether the statistics should be for trainees of the coach group with the given target_id. |
enabled | boolean | No | — | Whether or not this schedule reports event subscription is enabled. |
endpoint_id | integer | Yes | — | The logging endpoint’s ID, which is generated after creating a webhook or websocket successfully. |
frequency | string | Yes | — | How often the report will execute. |
name | string | Yes | — | [single-line only] The name of the schedule reports. |
on_day | integer | Yes | — | The day of the week or month when the report will execute considering the frequency. daily=0, weekly=0-6, monthly=0-30. |
report_type | string | Yes | — | The type of report that will be generated. |
target_id | integer | No | — | The target’s id. |
target_type | string | No | — | Target’s type. |
timezone | string | No | — | Timezone using a tz database name. |
dialpad_admin_stats_create
Stats — Initiate Processing Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
coaching_group | boolean | No | — | Whether or not the statistics should be for trainees of the coach group with the given target_id. |
coaching_team | boolean | No | — | Whether or not the statistics should be for trainees of the coach team with the given target_id. |
days_ago_end | integer | No | — | End 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_start | integer | No | — | Start 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_type | string | Yes | — | Whether to return aggregated statistics (stats), or individual rows for each record (records). NOTE: For stat_type “csat” or “dispositions”, only “records” is supported. |
group_by | string | No | — | This 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_today | boolean | No | — | Whether 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_id | integer | No | — | ID 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_type | string | Yes | — | The type of statistics to be returned. NOTE: if the value is “csat” or “dispositions”, target_id and target_type must be specified. |
target_id | integer | No | — | The target’s id. |
target_type | string | No | — | Target’s type. |
timezone | string | No | — | Timezone using a tz database name. |
dialpad_admin_stats_get
Stats — Get Result Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Request ID returned by a POST /stats request. |
dialpad_admin_tags_patch
Number Tags — Update tags for a phone number. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
do_not_call | boolean | No | — | Whether calls should be blocked for this number. |
do_not_text | boolean | No | — | Whether texts should be blocked for this number. |
phone | string | Yes | — | The phone number in E.164 format (e.g., “+14155551234”). |
dialpad_admin_webhook_update
Webhook — Update Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The webhook’s ID, which is generated after creating a webhook successfully. |
hook_url | string | No | — | The webhook’s URL. Triggered events will be sent to the url provided here. |
secret | string | No | — | [single-line only] Webhook’s signature secret that’s used to confirm the validity of the request. |
dialpad_admin_webhooks_create
Webhook — Create Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hook_url | string | Yes | — | The webhook’s URL. Triggered events will be sent to the url provided here. |
secret | string | No | — | [single-line only] Webhook’s signature secret that’s used to confirm the validity of the request. |
dialpad_admin_webhooks_delete
Webhook — Delete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The webhook’s ID, which is generated after creating a webhook successfully. |
dialpad_admin_webhooks_get
Webhook — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The webhook’s ID, which is generated after creating a webhook successfully. |
dialpad_admin_webhooks_list
Webhook — List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
secret | string | No | — | [single-line only] Websocket’s signature secret that’s used to confirm the validity of the request. |
dialpad_admin_websockets_delete
Websocket — Delete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The websocket’s ID, which is generated after creating a websocket successfully. |
dialpad_admin_websockets_get
Websocket — Get Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The websocket’s ID, which is generated after creating a websocket successfully. |
dialpad_admin_websockets_list
Websocket — List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The websocket’s ID, which is generated after creating a websocket successfully. |
secret | string | No | — | [single-line only] Websocket’s signature secret that’s used to confirm the validity of the request. |

