Properties

​

What are properties?

Properties are custom fields you define to store additional data on your contacts. Out of the box, contacts have email, first name, and last name. Properties let you add anything else — company name, plan type, signup date, credit balance, or whatever your application needs.

​

Supported types

​

Creating a property

Go to Contacts > Properties and click Create Property. You can also create properties via the API.

​

Setting values on contacts

Each contact can have a value for each property. You can set values from:

• The contact detail page in the dashboard
• The API when creating or updating a contact

If a property value is not set on a contact, the fallback value is used wherever that property is referenced (e.g., in email templates).

​

Using properties in segments

Properties can be used as filter conditions in Segments. All operators are available — equals, contains, greater than, is set, etc. For example, you can create a segment for “all contacts where plan equals pro” or “all contacts where credits is greater than 100”.

​

Using properties in templates

Properties are available as merge tags in email templates. When the email is sent, the tag is replaced with the contact’s value — or the fallback value if not set.

​

Deleting a property

A property cannot be deleted if it’s used in a segment filter. Remove it from all segment conditions first. When a property is deleted, all stored values for that property across all contacts are also removed.

​

FAQ