---
title: "Add Contact to Blocklist"
method: POST
path: "/v2/subscribers"
tags: ["Subscribers"]
---

# Add Contact to Blocklist

`POST /v2/subscribers`

This endpoint allows you to add a contact to the blocklist in the same request.

According to the type of delivery channel, the contact can be added to the blocklist with its corresponding **Sender**.

**NOTE**: if the contact is added in different senders, regardless of the delivery channel, the end user will be able to receive messages. Therefore, each sender has its own blocklist.

For more information how to add a contact to the blocklist, go to the [Blocklisted Contact](https://docs.messangi.com/docs/blocklisted-subscriber#/) section.

## Request body

- SubscriberRequestBody
  - `to` string, required — <p>Enter the contact data you want to add to the blocklist according to the sending entity and delivery channel.</p> <p>To add a contact to the blocklist via SMS, WhatsApp or RCS, you need to provide the phone number of the contact.</p><p>To add a contact to the blocklist via Email, you need to provide the email address of the contact.</p>
  - `reason` string, required — Enter the reason why the contact is added to the blocklist.
  - `type` 'SMS' | 'EMAIL' | 'WHATSAPP' | 'RCS', required — <p>Type of delivery channel, in which the contact will no longer receive messages.</p><p><ul><li><code>´SMS´</code></li><li><code>´EMAIL´</code></li><li><code>´WHATSAPP´</code></li><li><code>´RCS´</code></li></ul></p>
  - `from` string, required — <p>Enter the sending identity (Sender) according to the delivery channel.</p> <p>Each sender has its own blocklist.</p>
  - `listType` 'BLACK', required — <p>Type of list to which the contact is added.</p> <p><ul><li><code>´BLACK´</code></li></p>

## Response `200`

new contact added

- SubscriberResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure
  - `data` SubscriberDTO — Contact Information.
    - `id` string, required — Unique identifier of the blocklisted contact.
    - `to` string, required — <p>Contact data you want to add to the blocklist according to the sending entity and delivery channel.</p> <p>To add a contact to the blocklist via SMS, WhatsApp or RCS, you need to provide the phone number of the contact.</p><p>To add a contact to the blocklist via Email, you need to provide the email address of the contact.</p>
    - `reason` string, required — The reason why the contact is added to the blocklist.
    - `date` string, date-time — Date when the contact was added to the blocklist.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — List not found
- `409` — Contact already exist
- `410` — Token expired
- `500` — Internal server error

---

[API](https://skmtc.net/messangi/apis/raven.md) · [All operations](https://skmtc.net/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messangi/raven/versions/c87f398fa338/schema)