The Constituents section is where you manage all the people your agents interact with — your student population (e.g. leads), their data, and the rules that determine who each agent engages with.
To get there, click Constituents in the left sidebar.
The section has four tabs: Segments, Constituents, Properties, and Provenances.
Constituents
A constituent is an individual person in your CollegeVine ecosystem (e.g., a lead, current student, parent, etc.). Your full constituent list lives here. Each row shows the constituent's name and their
Source — where they entered the platform (e.g., a Salesforce sync, SFTP import, or manual upload). A constituent can have more than one source if they've come in through multiple channels.
Searching: Use the search bar to find a specific constituent by name.
Exporting: Click Export to download your full constituent list as a CSV.
Adding constituents manually
Click + New to open the manual upload flow.
Upload a CSV file. At minimum, your file must include these columns (plus any additional fields you’d like to include additionally):
First name
Last name
Email
Check the confirmation box to confirm that all contacts in the file are expecting to hear from your organization.
Click Next to proceed to the field mapping step, where you’ll match your CSV columns to constituent properties.
You can download an example CSV file from the upload modal for reference.
Segments
Segments are filtered groups of constituents (e.g. all leads from New York could make up the ‘New York Segment’). Each of your agent’s workflows is scoped to one or more segments — the segment determines which constituents the agent engages with for that workflow.
Creating a new segment
Click + New.
Enter a Segment name.
Click + Add filter and select a constituent property to filter on (e.g. admission year, state, etc.). You can add multiple filters to narrow the group.
Click Save segment.
Once saved, the segment will appear in your list with a constituent count. You can reference it when configuring a workflow workflow.
Properties
Properties are the data fields associated with your constituents — things like admission status, enrollment year, contact information, or any custom fields your institution tracks. You’ll see all properties here, including standard fields and any custom ones that have been added.
Creating a new property
Click + New.
Fill in the following:
Property name — the field label as it will appear across the platform
Property description — optional, but useful for clarifying what the field contains
Property type — select Text, Number, or another available type. Note: property type cannot be changed after the property is created.
Contains sensitive data — check this if the field contains information that should be protected. When checked, constituent authentication is required before agents can access this property.
Workflow permissions — controls how agents can interact with this property. Options:
None — if this property contains sensitive data, agents may only use the retrieve_sensitive_properties tool to read it
Read — agents may view the property but not modify it
Set when missing — agents may read the property and set its initial value for constituents, but not overwrite an existing value
Modify — agents may read or modify this property freely
Click Save.
Provenances
Provenances show where your constituents came from. Each entry represents a data source that has contributed constituent records — for example, a Salesforce sync, an SFTP import, a manual upload, or a cold inbound interaction (such as a student who reached out through your webchat or inbound email).
Provenances are recorded automatically as constituents enter the platform through different channels. This tab is read-only — you can use it to understand where your constituent data is coming from, but provenances are managed through your integrations and upload settings, not directly here.