Blacklist API for Email as a Channel (Async Mode)

Suggest Edits

This API can be used to blacklist email as a channel for users in the CE platform. If the user is already present in the platform, this API will simply update the blacklist status of the user. The user will not receive any further email communication from the platform. However, the user can still receive communication via other channels (SMS, APN and Web Push etc). If required communication handle exist.

If the user is not present in the platform, this API will add the user and also update the status as blacklist.

Details:

URL Schema:
US IDC: https://api.netcoresmartech.com/v3/contact/blacklist

URL Schema:
Indian IDC: https://apiin.netcoresmartech.com/v3/contact/blacklist

URL Schema:
EU IDC: https://goapiv3.eu-north-1.eu.netcoresmartech.com/v3/contact/blacklist

Header:

Key	Value
Content-Type	application/json

Parameter:

Parameter	Description	Data type	Required	Parameter type
activity	Activity refers to the action that is being performed through the API, that is, add, delete, update, blacklist so on. Value here: blacklist	String	Yes	Query Parameter
api-key	You can obtain the API key from the CE panel. Log in to your CE panel and go to Admin. Enable the API Mode in Account Configuration under Advance details. Now, go to User management and click Edit either on your user name or admin user. To retrieve your API key here.	String	Yes	Header Parameter
type	It represents the module or group the API belongs to. For example, if the API 's functionality is related to Contacts, type is 'contact'. Value here: Contact	String	No	Query parameter
primarykey	It represents the unique identification of the contact. For eg: email ID, client ID, mobile no etc.	String	Yes	Header parameter
channel	It represents the channel that needs to be blacklisted. Value here: email. Note: by default email channel will only get blacklisted irrespective of whatever is the primary key	String	No	Header parameter
data	Data is the Post body containing the array of email ids, client ids, mobile numbers etc for eg: { "data": [ "[email protected]" ] } primary key is email id for the above example. If its client id, mobile number etc , the same needs to be passed.	JSON array of strings	Yes	Body parameter

Request:

'https://api.netcoresmartech.com/v3/contact/blacklist' \
--header 'api-key: 085164d1083970906270bb24e97a0b82' \
--header 'primarykey: email' \
--header 'channel: email' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [
"[email protected]"
]
}'

Example of array: You can pass maximum 1000 primary keys in one array at a time

'https://api.netcoresmartech.com/v3/contact/blacklist' \
--header 'api-key: 085164d1083970906270bb24e97a0b82' \
--header 'primarykey: email' \
--header 'channel: email' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [
"[email protected]",
"[email protected]",
"[email protected]",
]
}'

Response: 200 OK

{
 "message": "dd5d16cc-85ac-fe74-8894-fc7ff750806b",
 "status": 200
}

For blank apikey validation:

{
    "message": "api key can not be blank",
    "status": 400
    }

For blank primary key:

{
    "message": "primary key is mandatory and should be string",
    "status": 400
    }

For invalid api key:

{
    "message": "Invalid api key",
    "status": 401
 }

For data type of array and length equal to zero:

{
    "message": "data should be of type array and length greater than zero",
    "status": 400
}

For batch limit exceeding 1000:

{
    "message": "You have exceeded the batch limit of 1000",
    "status": 400
 }

📘
Note:

This API does not support mass blacklisting. That is primary key is mobile number, that has two contacts with same email ID but different contact number. Only the contact number which is passed, the email ID attributed to it will only get blacklisted.

To check if the email id is blacklisted or not, you can check the user status under audience>>All Contacts>>Blacklisted Contacts

Irrespective of whatever is the primary key, only email as a channel will get blacklisted

If invalid data is passed in array, the API will give success message as "200". But the same will not get blacklisted. You can request for the log or check on the UI under audience>>All Contacts>>Blacklisted Contacts

Updated 5 months ago

📘Note:

📘
Note: