The Participant Updated data export provides insight on a variety of participant information changes (e.g., demographic field, custom field, or invitation status changes). Participant information can be updated in a variety of ways, including:
- Manually by a coordinator, via the Participant Info tab
- Through survey responses (submitted by the participant or by a coordinator via a coordinator entered survey, if applicable)
- By participant-initiated account updates, such as name or email updates
- When a participant unsubscribes from email or SMS notifications (e.g., by responding STOP to a text or clicking unsubscribe at the bottom of an email)
- Through Participant API calls
- Via schedules (that update a demographic or custom field)
- Via segment actions
Participants may also be marked as UnsubscribedFromEmail if an email send generates a Bounce or Complaint event.
Table of Contents
Data Fields
| Field | Description |
|---|---|
ParticipantIdentifier |
The identifier of the participant the notification or survey was delivered to. Can be used to cross reference with Participants. |
Timestamp |
The timestamp of the update, in UTC. |
ParticipantID |
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
Change |
Everything that has changed for the participant. |
UserType |
The type of user that made the update, for example, Participant, Coordinator, System (for changes resulting from a schedule), ServiceAccount. |
User |
The user that made the update. For an update made by a Coordinator, this will be the coordinator’s email address. For an update made by a service account, this will be the service account’s name. |
SurveyID |
The ID of the survey that generated the participant update. |
ScheduleID |
The ID of the schedule that updated the participant’s information. |
Sample CSV Export
ParticipantIdentifier,Timestamp,ParticipantID,Change,User,UserType,SurveyID,ScheduleID
MDH-1744-6293,2023-06-26T22:18:41Z,ceafa880-d13d-4629-9d42-8fd2b82a8ed1,"{""Demographics"":{""Email"":""example+participantupdate1@careevolution.com""},""CustomFields"":{},""InvitationStatus"":""Pending""}",example@careevolution.com,Coordinator,,
MDH-1744-6293,2023-06-26T22:37:40Z,ceafa880-d13d-4629-9d42-8fd2b82a8ed1,"{""Demographics"":{""UtcOffset"":""-07:00:00"",""TimeZone"":""America/Los_Angeles""}}",,Participant,,
MDH-1744-6293,2023-06-26T22:37:41Z,ceafa880-d13d-4629-9d42-8fd2b82a8ed1,"{""CustomFields"":{""Cohort"":""B""}}",,System,,f66ea51b-7976-4d7b-8e9c-8de939111fb7
MDH-1744-6293,2023-08-09T22:10:51Z,ceafa880-d13d-4629-9d42-8fd2b82a8ed1,"{""Demographics"":{""UnsubscribedFromEmails"":""true""}}",,Participant,,
Sample JSON Export
{
"ParticipantID": "ceafa880-d13d-4629-9d42-8fd2b82a8ed1",
"ParticipantIdentifier": "MDH-1744-6293",
"Timestamp": "2023-06-26T22:18:41Z",
"Properties": {
"Change": "{\u0022Demographics\u0022:{\u0022Email\u0022:\u0022example+participantupdate1@careevolution.com\u0022},\u0022CustomFields\u0022:{},\u0022InvitationStatus\u0022:\u0022Pending\u0022}",
"UserType": "Coordinator",
"User": "example@careevolution.com"
}
}
{
"ParticipantID": "ceafa880-d13d-4629-9d42-8fd2b82a8ed1",
"ParticipantIdentifier": "MDH-1744-6293",
"Timestamp": "2023-06-26T22:37:40Z",
"Properties": {
"Change": "{\u0022Demographics\u0022:{\u0022UtcOffset\u0022:\u0022-07:00:00\u0022,\u0022TimeZone\u0022:\u0022America/Los_Angeles\u0022}}",
"UserType": "Participant"
}
}
{
"ParticipantID": "ceafa880-d13d-4629-9d42-8fd2b82a8ed1",
"ParticipantIdentifier": "MDH-1744-6293",
"Timestamp": "2023-06-26T22:37:41Z",
"Properties": {
"Change": "{\u0022CustomFields\u0022:{\u0022Cohort\u0022:\u0022B\u0022}}",
"UserType": "System",
"ScheduleID": "f66ea51b-7976-4d7b-8e9c-8de939111fb7"
}
}
{
"ParticipantID": "ceafa880-d13d-4629-9d42-8fd2b82a8ed1",
"ParticipantIdentifier": "MDH-1744-6293",
"Timestamp": "2023-08-09T22:10:51Z",
"Properties": {
"Change": "{\u0022Demographics\u0022:{\u0022UnsubscribedFromEmails\u0022:\u0022true\u0022}}",
"UserType": "Participant"
}
}