# VIA Email Rejection Link Generation

This method allows service providers to generate unique rejection links for email addresses that are approved in the IYS (Electronic Commercial Message Management System). Service providers can include these links in their emails to offer recipients the option to opt out. A maximum of 100 `REJECT` links can be created simultaneously for recipients whose permission status is `APPROVED` in IYS.

{% hint style="warning" %}
I**mportant Notes:**

1. The request must include the recipient's email address (`recipient`) and recipient type (`recipientType`).
2. If the request is successful, the response will contain a generated rejection link (URL) along with the recipient's email address.
   {% endhint %}

#### **Successful Rejection Process:**

* If the recipient's (`recipient`) permission status is `APPROVED`, it is updated to `REJECT` upon execution.

**Note:** The generated email links can be embedded within customer emails. Users can click on these links to opt out of receiving email notifications. Once a rejection is made, it is reflected in IYS. Netmera monitors and updates user permissions nightly based on IYS task results.

## <mark style="color:green;">Request Body Parameters</mark>

<pre class="language-json"><code class="lang-json"><strong>curl --location 'https://restapi.netmera.com/via/generate-reject-mail-link' \
</strong>--header 'X-netmera-api-key: your_rest_apikey' \
--header 'Content-Type: application/json' \
--data-raw '{
  "recipients": [
    {
      "recipient": "String", // Email address to be unsubscribed [Required]
      "recipientType": "String" // Type of the email address. Accepted values: BIREYSEL (Individual) or TACIR (Corporate) [Required]
    }
  ]
}
</code></pre>

**Response Body (HTTP Code: 200)**

```json
[
  {
    "url": "String", // Generated rejection link
    "recipient": "String", // Corresponding email address
    "code": "String", // Error code (if applicable) [Optional]
    "message": "String" // Error message (if applicable) [Optional]
  }
]
```

## <mark style="color:green;">Error Responses</mark>

**HTTP Code: 400**

```json
{
  "errors": [
    {
      "message": "String", // Description of the error
      "code": "String", // Error code
      "value": "String", // Incorrect value sent in the request
      "location": ["String"] // Fields in the request that contain errors
    }
  ]
}
```

**HTTP Code: 500**

```json
{
  "message": "Error while parsing the data."
}
```

## <mark style="color:green;">**Example Successful Request**</mark>

```json
curl --location 'https://restapi.netmera.com/via/generate-reject-mail-link' \
--header 'X-netmera-api-key: your_rest_apikey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recipients": [
        {
            "recipient": "..x@gmail.com",
            "recipientType": "BIREYSEL"
        },
        {
            "recipient": "..y@gmail.com",
            "recipientType": "BIREYSEL"
        }
    ]
}'
```

**Example Successful Response (HTTP Code: 200)**

```json
[
    {
        "url": "generated_rejection_link",
        "recipient": "..x@gmail.com"
    },
    {
        "recipient": "..y@gmail.com",
        "code": "H568",
        "message": "Sadece ONAY durumunda olan izinler için link üretilmelidir."
    }
]
```

## <mark style="color:green;">**Example Failed Request**</mark>

**Case:** An invalid `recipientType` value is sent.

```json
curl --location 'https://restapi.netmera.com/via/generate-reject-mail-link' \
--header 'X-netmera-api-key: your_rest_apikey' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recipients": [
        {
            "recipient": "x@gmail.com",
            "recipientType": "test"
        },
        {
            "recipient": "y@gmail.com",
            "recipientType": "BIREYSEL"
        }
    ]
}'
```

**Example Error Response (HTTP Code: 400)**

```json
{
    "errors": [
        {
            "message": "Alıcı tipi (recipientType) için uygun değerler: BIREYSEL, TACIR",
            "code": "H116",
            "value": "test",
            "location": [
                "recipientType"
            ]
        }
    ]
}
```