PUT /messaging/v1/email/seed-lists/{id}

Overview

Update a single seed list for an account. The MID and partner appId are used from authentication. The {id} in the URL path is the globally unique ID assigned by the system at creation.

A seed-list is retained for 60 days. To keep them active, update seed lists every 30 days, even when they're unchanged. Any seed-lists existing before this call are replaced by the ones provided in the JSON payload. An account can have 20 seed-lists, and each seed-list is allowed 500 seeds.

JSON Parameters

NameType  Description
namestring  The name given at creation or update.
descriptionstring  A description of the seed-list.
seedslist of objects  The objects in the list each consist of a single name:value pair.
  NameType 
  emailstringan email address.

Response

StatusNameType  Description
200    Successful response indicating the request passed validations.
 namestring  The name given at creation or update.
 descriptionstring  A description of the seed-list.
 seedslist of objects  The objects in the list each consist of a single name:value pair.
   NameType 
   emailstringan email address.
200    Successful response but with an empty object, indicating no active seed-lists for the partner appID.

Validation Failure Scenarios

HTTP StatusDescription
401Seed-list doesn't belong to the partner ID.
429API rate limit throttling is preventing success.

Usage

Example Request

Example Responses