Using this API, you can create a Block Number group within your Cloud Agent account, allowing you to add multiple numbers.
To use this API with the help of a token, follow these steps:
- Generate the Token: Use the 'Generate Token' API to obtain an authentication token.
- Enter the Token ID: Navigate to the right section of this page, under the 'AUTHORIZATION' tab. Here, input the generated token ID.
- With the token entered, pass the below header and body parameters:
Header parameters
| Parameter | Description |
|---|---|
| Content-Type | application/json |
Body Params
{
"userName":"xxxxx",
"name":"xxxxxx",
"description":"xxxx",
"blockNumbers":"12345678966",
"expiryDate":"YYYY-MM-DD HH:MM:SS"
}
Parameter | Description |
|---|---|
userName | Your CloudAgent account username |
name | Name for the block number group |
description | Enter the description for the group |
blockNumbers | Phone numbers to be added to the group |
expiryDate | Add the expiry date for the number, this indicates the duration you want the number to remain in the blocked list. |
Rate Limit
This API supports the addition of up to 100 phone numbers in a single request.
Possible responses
Passing Invalid 'username' in Authorization | {"status": "error","message": "Authentication failed"} |
Passing Invalid 'password' in Authorization | {"status": "error","message": "Authentication failed"} |
Passing invalid namekey parameter. | { "status": "error","message": "Parameters are mandatory"} |
Passing invalid namevalue parameter | {"status": "error","message": "invalid data","errors": {"name": "Name (X) allows 2 to 50 characters only"}} |
Passing invalid descriptionkey parameter. | { "status": "error","message": "Parameters are mandatory"} |
Passing invalid descriptionvalue parameter. | {"status": "error","message": "invalid data","errors": {"name": "Name (B) allows 2 to 50 characters only"}} |
Passing invalid blockNumbers value parameter. | {"status": "error","message": "invalid data","errors": {"blockNumbers": "Blocknumbers data contains invalid format of numbers"}} |
Successfully group is created with multiple numbers | "{""status"": ""success"",""message"": ""created"",""input"": {""name"": ""XXXX"",""description"": ""XXXX"", |