updateList method changes the properties of a contact list you select for a campaign.
Principle of use
| Syntax and URL to call the method |
| updateList (int list_id, string title, string before_subscribe_url, string after_subscribe_url, array sub_user_rights]) |
| https://api.selzy.com/en/api/updateList?format=json&api_key=KEY&list_id=ID&title=NewListName |
| Arguments | |
| api_key * | API access key. |
| list_id * | List code obtained using the getLists or createList method. |
| title * | List name. It must be unique in your account. Examples:
title=NewListTitle title=%D0%9D%D0%BE%D0%B2%D1%8B%D0%B9 («New» in the UTF-8 format) |
| before_subscribe_url | This URL redirects contacts to a page that comes after they submit the subscription form, but before they confirm their subscription. This page usually tells contacts to check their email and follow the confirmation link to complete the subscription.
You can use merge tags in the URL to pass contact-specific data. For example, you can include the contact's email address or an ID stored in a custom field. |
| after_subscribe_url | This URL redirects to the post-subscription page. Usually this page shows a message that the subscription has been completed successfully.
You can use merge tags in the URL to pass contact-specific data. For example, you can include the contact's email address or an ID stored in a custom field. |
| sub_user_rights[<sub_user_id>][<right>] | Access rights to the list for additional account users (no more than 10 additional users per request).
This parameter is available only for additional users who have the “Individual access settings for selected lists” option enabled. <right> can have the following values: access, send_email, send_sms. For access, the available values are: view_stats, view, manage, none (none removes the additional user’s access to the list). For send_email and send_sms, the available values are: 0, 1. |
| Return value | |
| Empty JSON object
If there are any errors or warnings, they are returned in the error/warnings fields as described. |
|