Add numbers to blacklist

POST

https://platform-api.convirza.com/v3/blacklist

Blacklist

Last modified:2026-07-24 13:10:44

Adds one or more phone numbers to the blacklist for specified organization units.

What blacklisting does
Blacklisted phone numbers will be blocked from making calls to the organization.

Duplicate handling
If a phone number is already blacklisted for an organization, it will not be added again. The response separates successfully blacklisted numbers from those already in the blacklist.

Response
Returns an object with two arrays: blacklisted (newly added entries) and already_blacklisted (numbers that were previously blacklisted).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Numbers added to blacklist successfully

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Single numberMultiple numbers

curl --location 'https://platform-api.convirza.com/v3/blacklist' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
    {
        "caller_id": "2342342342",
        "org_unit_id": 70035
    }
]'

Response Example

201 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "blacklisted": [
            {
                "caller_id": "2342342342",
                "org_unit_id": 70035
            }
        ],
        "already_blacklisted": []
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-07-24 13:10:44

List blacklisted numbers

Delete numbers from blacklist