Update List

Updating a list can be to rename a list or to associate a signup form to the list. Using this API, you can make changes in mailing lists.

Scope required

  • ZohoMarketingAutomation.lead.UPDATE

Other alternative scopes

  • ZohoMarketingAutomation.lead.CREATE-UPDATE (CREATE + UPDATE)

  • ZohoMarketingAutomation.lead.WRITE (CREATE + UPDATE + DELETE)

  • ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)

Header:

Authorization: Zoho-oauthtoken <access_token>

Content-Type: application/x-www-form-urlencoded

Request type:

  • Post

Request URL

https://marketingautomation.zoho.com/api/updatelistdetails

List of parameters

Parameter

Data type

Description

listkey*

String

List Key to send a subscription mail to leads.

resfmt

String

JSON

newlistname*

String

Give list name.

signupform*

String

public/private

* - Mandatory parameters

Possible error cases

Error code

Description

903

Mandatory fields are missing.

2102

Listkey is empty or invalid.

2206

List has been deleted.

If your error code is not listed above, click here.

Sample request

Copiedhttps://marketingautomation.zoho.com/api/v1/updatelistdetails?resfmt=JSON&listkey=[listkey]&newlistname=[give list name]&signupform=[public/private]

Sample Response

Copied{
"message": "List updated successfully.",
"status": "success",
"code": "0",
"uri": "/api/v1/updatelistdetails",
"version": "1"
}