Guest identifiers data model

When you create a batch file, ensure that you follow the formatting requirements and include attributes from the following table:

Attribute	Description	Type	Example(s)	Insert	Upsert	Migration
`provider`	The provider of the identifier.	string (title case)	`"CRM_SYSTEM"`, `"SITECORE_IDENTITY_SYSTEM"`	Not supported	Required	Required
`id`	The unique ID of the identifier.	string (uppercase)	`"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41"`	Not supported	Required	Required
`expiryDate`	The date and time after which the identifier is no longer valid.	ISO 8601 date/time UTC	`"2025-08-23T16:17:16.000Z"`	Not supported	Optional	Optional

Here's an example that includes Personally Identifiable Information (PII) and uses upsert mode:

RequestResponse

{
   "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46",
   "schema":"guest",
   "mode":"upsert",
   "value":{
      "guestType":"customer",
      "firstSeen":"2025-03-07T16:15:11.000Z",
      "lastSeen":"2025-08-23T16:17:16.000Z",
      "title":"Mr",
      "firstName":"John",
      "lastName":"Does",
      "gender":"male",
      "dateOfBirth":"1985-12-24T00:00Z",
      "email":"[email protected]",
      "nationality":"Irish",
      "street":[  
         "Apartment 15",
         "West Drive Avenue"
      ],
      "city":"Dublin",
      "country":"IE",
      "postCode":"D2",
      "state":"Dublin",
      "identifiers":[
         {
            "provider":"SITECORE_IDENTITY_SYSTEM",
            "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
            "expiryDate":"2025-08-23T16:17:16.000Z"
         }
      ]
   }
}

Here's an example that includes the identifiers attribute and uses upsert mode.

RequestResponse

{
   "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46",
   "schema":"guest",
   "mode":"upsert",
   "value":{
      "guestType":"customer",
      "firstSeen":"2025-03-07T16:15:11.000Z",
      "lastSeen":"2025-08-23T16:17:16.000Z",
      "identifiers":[
         {
            "provider":"SITECORE_IDENTITY_SYSTEM",
            "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
            "expiryDate":"2025-08-23T16:17:16.000Z"
         }
      ]
   }
}

Do you have some feedback for us?

If you have suggestions for improving this article,