Skip to main content

Participant Updated Export Format

  • Updated

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"
    }
}

Was this article helpful?