---
title: "Create Contact"
method: POST
path: "/v3/lists/{listId}/subscribers"
tags: ["Subscribers"]
---

# Create Contact

`POST /v3/lists/{listId}/subscribers`

.

## Path parameters

- `listId` integer, required

## Request body

- string

## Response `200`

Accepted the request to create the contact

- 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

- `201` — Accepted the request to create the contact
- `400` — Bad request
- `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)