POST /messaging/v1/email/seed-lists/
Creates a seed-list for an account. The MID and Partner AppId is used from authentication. There's a retention period of 60 days for the seed-list. To stay active, update seed lists every 30 days, even when they're unchanged. An account can have 20 seed-lists, and each seed-list is allowed 500 seeds.
| Name | Type | | | | Description |
|---|
| name | string | | | Required | Names the seed-list to be created. |
| description | string | | | | If the name doesn't fully describe the seed-list, a description is provided. |
| seeds | array of objects | | | Required | Holds a list of objects, each containing a single name:value pair. |
| | | Name | Type | | |
| | | email | string | Required | Each record, up to and including 500, contains a valid email address of the seed. |
| Status | Name | Type | Description |
|---|
| 201 | | | Successful creation of a seed list |
| | id | string | A globally unique identifier (GUID) |
| HTTP Status | Description |
|---|
| 400 | The proposed seed-list name exists already. |
| 400 | Partner App has 20 active seed-lists. |
| 400 | The request has more than 500 seeds |
| 400 | The seed-list name is longer than 128 characters. |
| 400 | An email address under seeds is incorrect in format. |
| 401 | The request comes from an invalid partner app. |
| 429 | API rate limit throttling is preventing success. |