POST /phone/blocked_list

A Zoom account owner or a user with admin privilege can block phone numbers for phone users in an account. Blocked numbers can be inbound (numbers will be blocked from calling in) and outbound (phone users in your account won't be able to dial those numbers). Blocked callers will hear a generic message stating that the person they are calling is not available.
Use this API to create a blocked list and add a number to that blocked list.
Prerequisites:

Rate Limit Label: Light

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
comment String No

Provide a comment to help you identify the blocked number or prefix.

match_type String No

Specify the match type for the blocked list. The values can be one of the following:

phoneNumber: Choose this option (Phone Number Match) if you want to block a specific phone number. Then, in the phone_number field, provide the phone number along with the country code.

prefix: Choose this option (Prefix Match) if you want to block all numbers with a specific country code and area code. Next, in the phone_number field, enter a country code as part of the prefix. For example, entering 1907 blocks numbers with country code 1 and area code 907.

Valid values:

  • "phoneNumber"
  • "prefix"
status String No

Enable or disable the blocking. One of the following values are allowed:
active: Keep the blocking active.
inactive: Disable the blocking.

Valid values:

  • "inactive"
  • "active"
block_type String No

State whether you want the block type to be inbound or outbound.
inbound: Pass this value to prevent the blocked number or prefix from calling in to phone users.
outbound: Pass this value to prevent phone users from calling the blocked number or prefix.

Valid values:

  • "inbound"
  • "outbound"
phone_number String No

The phone number to be blocked if you passed "phoneNumber" as the value for the match_type field. If you passed "prefix" as the value for the match_type field, provide the prefix of the phone number here including the country code. For example, entering 1905 blocks numbers with country code 1 and area code 905.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.