Save List Item

Add, update or remove a List item.


The following actions can be specified:

  • SET (default if no action is specified)
    Inserts or updates a Member in a List.
    When updating a Counter List, it increases or decreases the counter with the specified value, unless the replaceCounters attribute is set.
    When updating a Data List, only the fields specified in the updateColumns will be updated, leaving any other columns untouched.
  • ADD_ONLY
    Inserts a List Item if it doesn't already exist, but does NOT update the List Item if it already exists.
    This option is not applicable to Tag Lists.
  • UPDATE_ONLY
    Updates an existing List Item, but does NOT create it if it doesn't already exist.
    This option is not applicable to Tag Lists.
    When updating a Counter List, it increases or decreases the counter with the specified value, unless the replaceCounters attribute is set.
    When updating a Data List, only the fields specified in the updateColumns will be updated, leaving any other columns untouched.
  • REMOVE
    Removes the List Item. For Tag Lists this is the opposite of SET.
    This operation is not applicable for Subscription Lists.

The updateColumns must be used together with SET and UPDATE_ONLY for Data Lists to control exactly which fields get updated. It contains a comma-separated list of columns. A special value '\*' (just a star) can be used to refer to all fields.
Language
Click Try It! to start a request and see the response here!