# Distribution list e-mails insertion

This endpoint allows you to add new e-mail addresses to the distribution
list identified by its . In the response you will receive
structured info about the result of the insertion. In the


key there will be a list of e-mails successfully inserted, in the
 key, there will be a list of skipped e-mails, because
there were already in the list. In the

 key, there will be a list of invalid e-mails (wrong
format or non-existing MX domain record) and finally in the
 key, there will be a list of error messages

generated for invalid e-mails.

Endpoint: POST /api/mailing-lists/{code}
Version: 1.0.0
Security: shoptetAccessToken, shoptetPrivateApiToken

## Path parameters:

  - `code` (string, required)
    e-mail list code
    Example: "newsletters"

## Header parameters:

  - `Content-Type` (string, required)

## Request fields (application/json):

  - `data` (object, required)

  - `data.emails` (array, required)
    E-mails to add to the list

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.emailsInserted` (array, required)
    E-mails successfully added to the list

  - `data.emailsExisting` (array, required)
    E-mails skipped because they were already inserted before

  - `data.emailsInvalid` (array, required)
    E-mails skipped because of invalid format

  - `data.errorMessages` (array, required)
    Error messages of invalid e-mails

  - `errors` (array,null, required)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced