PUT target-lists/{listname}/members/{id}

Overview

The Target-List API permits interaction with target lists associated with your company.  You can use the API's PUT /v2/target-lists/{listname}/members/{id} call to add a member to the specified target list. If email is used as id it must be in lower case.
Performing this call on an {id} that is already a member of the target list will return a 200 OK but will not modify the target list.

Resource URI

PUT https://api.yesmail.com/v2/target-lists/{listname}/members/{id}

Call Description

The PUT target-lists/{listname}/members/{id} call adds a member to the specified target list.

HTTP Return Codes

Code

Description

200 OK

The request has succeeded.

400 Bad Request The request could not be understood by the server due to malformed syntax.  For instance, "id" in request payload does not equal {id} in URI. 

401 Unauthorized

The request requires user authentication.  Invalid Api-User and/or Api-Key header value.

404 Not Found

The target list {listname} does not exist or is archived, the subscriber {id} does not exist, or the email was in mixed case.

409 Conflict

This occurs when the If-Match condition is used, and the specified ETag does not match the current ETag for the resource.

 

Request Payload: 
{
    "id": "jsmith@zzz.com"
}
Response Payload: 
{
    "id": "jsmith@zzz.com",
    "email": "jsmith@zzz.com"
}