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 List Item.
    When updating a Counter List, it increases or decreases the counter with the specified value.
    When updating a Data List, by default only the passed in columns will be updated, leaving any other columns untouched. This can be overridden through the updateDataColumns attribute.
  • 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 Counter Lists, it increases or decreases the counter with the specified value.
    When updating a Data List, by default only the passed in columns will be updated, leaving any other columns untouched. This can be overridden through the updateDataColumns attribute.
  • REPLACE
    Adds a List Item if it doesn't exist, otherwise overwrites the entire List record.
    This is useful if resetting a Counter Lists to a specific value.
  • REMOVE
    Removes the List Item. For Tag Lists this is the opposite of SET.
    This operation is not applicable for Subscription Lists.

The updateColumns can 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 values.
Language
Click Try It! to start a request and see the response here!