Update Contact Attribute or List Values

In this article:

• Update contact attributes
• Update list membership
• Combine multiple update functions

Using Smarty utilities, you are able to update contact attributes and list values when a message is sent.

Use the following code to run the Smarty function. Replace attribute_key with the desired attribute to be updated and new_attribute_value with the new value.

{$utils->updateContact(['attribute_key'=>'new_attribute_value'])}

Update contact attributes

Update a string attribute

{$utils->updateContact(['flavor'=>'chocolate'])}

This will update the contact's flavor attribute to "chocolate".

Update a number

{$utils->updateContact(['viewed'=>'3'])}

This will update the contact's viewed attribute to "3".

If the attribute is a number value, you are able to increment or decrement by a specified amount.

Increment a number

{$utils->updateContact(['total'=>['inc' => '+1']])}

This will update a contact's total attribute by "+1".

Decrement a number

{$utils->updateContact(['viewed'=>['inc' => '-1']])}

This will update a contact's viewed attribute by "-1".

Update list membership

You can add or remove a contact to a specified list with the following code by replacing mylist with the name of the list to be updated and either true (on the list) or false (off the list).

{$utils->updateContact(['mylist'=>true])}

Add to a list

{$utils->updateContact(['weekly-specials'=>true])}

This will add the contact to the "weekly-specials" list.

Remove from a list

{$utils->updateContact(['weekly-specials'=>false])}

This will remove the contact from the "weekly-specials" list.

Combining multiple update functions

You are able to combine multiple update functions into one tag.

{$utils->updateContact(['flavor'=>'vanilla','age'=>['inc' => '+1']])}

This will update the contact's flavor attribute to "vanilla" and increment the age attribute "+1".

In the next article learn about using webhooks.