Contact Attributes

Store and manage custom data about your contacts and conversations.

What are attributes?

Attributes are key-value pairs that store information about contacts and conversations. Swiftsell uses them throughout the platform:

• In automation flows — collect values with the Collect Input block, use them in message text ({{attribute_name}}), and branch on them with the Condition block
• In campaigns — personalise template variables with contact attribute values
• In audience filters — segment your contacts based on attribute values
• In voice agents — save data collected during calls back to the contact record

---

Types of attributes

Contact attributes

Store information about a specific contact (person). Contact attributes persist across all conversations with that contact.

System attributes (built-in, read-only):

Attribute	Type	Description
phone	Text	Contact’s phone number (E.164 format)
name	Text	Contact’s display name
created_at	Date	When the contact was first seen
country	Text	Country code (auto-detected from phone number)
city	Text	City (if available from Meta)

Custom contact attributes — created by you in Settings → Attributes.

Conversation attributes

Store information about a specific conversation. Conversation attributes reset for each new conversation with the same contact.

Use conversation attributes for data that is specific to a single interaction (e.g., the support ticket category for this conversation, the product SKU the customer is asking about).

---

Creating attributes

Create custom attributes in Settings → Attributes. See Settings: Attributes for the full setup guide.

Attribute types:

Type	Use for
Text	Names, order numbers, free-form responses
Number	Ages, quantities, scores
Boolean	True/false flags (opted-in, verified, etc.)
Date	Birthdays, appointment dates

---

Using attributes in message text

Reference any attribute in a message body using double curly braces:

Hi {{contact.name}}, your order {{order_number}} is on its way!

Swiftsell replaces the placeholder with the attribute value at send time. If the attribute has no value, the placeholder is replaced with an empty string.

---

Updating attributes

Attributes can be updated:

• Manually — edit a contact’s profile directly in the Audience section
• Via Collect Input block — save the contact’s reply to an attribute automatically
• Via Quick Reply / List blocks — save the selected option to an attribute
• Via HTTP Request block — save API response values to attributes
• Via Voice Agent tools — save values collected during phone calls
• Via CSV import — bulk-update contact attributes by re-importing with updated data

See Update Attributes for details on each method.

---

Related pages

• Settings: Attributes — create and manage attribute definitions
• Filters and Segments — filter contacts by attribute values
• Update Attributes — all the ways to set attribute values