--- schema_version: "1" id: 6f26c9686b81fe62882c47d289174c18dacd4607e1b9d99cf145a8a99dc70c37 title: PUT /messaging/v1/email/seed-lists/{id} collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/messageUpdateSeedListForAccount.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/messageUpdateSeedListForAccount.html source_site: developer.salesforce.com content_type: documentation content_hash: 914037dfc3e235619ba8db88d321ed431617c6327635c0eb173516980a290b23 products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # 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 | **Name** | **Type** |   |   | **Description** | | ----------- | --------------- | -------- | -------- | ------------------------------------------------------------------ | | name | string |   |   | The name given at creation or update. | | description | string |   |   | A description of the seed-list. | | seeds | list of objects |   |   | The objects in the list each consist of a single name\:value pair. | |   |   | **Name** | **Type** |   | |   |   | email | string | an email address. | ## Response | **Status** | **Name** | **Type** |   |   | **Description** | | ---------- | ----------- | --------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------- | | 200 |   |   |   |   | Successful response indicating the request passed validations. | |   | name | string |   |   | The name given at creation or update. | |   | description | string |   |   | A description of the seed-list. | |   | seeds | list of objects |   |   | The objects in the list each consist of a single name\:value pair. | |   |   |   | **Name** | **Type** |   | |   |   |   | email | string | an email address. | | 200 |   |   |   |   | Successful response but with an empty object, indicating no active seed-lists for the partner appID. | ### Validation Failure Scenarios | **HTTP Status** | **Description** | | --------------- | ------------------------------------------------ | | 401 | Seed-list doesn't belong to the partner ID. | | 429 | API rate limit throttling is preventing success. | ## Usage ### Example Request ```json PUT /messaging/v1/email/seed-lists/{id} { "name": "{seed-list-name}", "description": "some description", "seeds":[ {"email": "address1@example.com"}, {"email": "address2@example.com"}, {"email": "address3@example.com"} ] } ``` ### Example Responses ```json 200 OK { "id": "fb9a8b12-a088-4999-b9ce-f8cd3fe06386", } ``` ```json 200 OK {} ``` ## Related Items - [Seed-List in Rest Reference](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/routes.md#seed-list) - [Seed-List Management API](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/messageSeedListManagement.md)