Check Required Registration Fields

A registration is considered invalid if it doesn’t contain all the required fields, or if there are errors in the required fields. If a registration is invalid, the device is set to an inactive or opted-out state.

To verify that the registration information is properly recorded, review how to test and validate registrations.

Registrations are asynchronous. The SDK can receive a successful 201 response from the server, which indicates that it received the registration request. However, it can’t determine whether the server successfully processed the request or if it marked the registration as invalid.

Note

This code sample shows an example of a registration request.

1{
2  "mobileAppVersion": "10.0.0",
3  "dateTimeInDevice": "2025-11-20T12:40:58.623Z",
4  "deviceVersion": "18.5",
5  "partyIdentificationName": "Testing-Name",
6  "devicePlatform": "iPhone OS",
7  "deviceId": "5784dd5a-053e-4d23-a05e-6abfbeb4dfb0",
8  "locale": "en_US",
9  "partyIdentificationNumber": "123456",
10  "deviceModel": "iPhone13",
11  "registrationId": "6241b7d1-8d42-4aa4-bbe9-7607cf7092b0",
12  "deviceTimeZone": "Asia/Kolkata",
13  "mobileAppName": "SDKExplorer",
14  "eventId": "0fb1e9d5-9e92-4e95-82ec-5f5e4544d35c",
15  "mobileAppId": "com.exacttarget.sdkx",
16  "pushEnabled": true,
17  "deviceSystemToken": "f3658491895d40c79377120332bb9b3dexample",
18  "sdkVersion": "1.0.0",
19  "partyIdentificationType": "Testing-iOS",
20  "attributes": [
21    {
22      "key": "CODE",
23      "value": "FREE99"
24    }
25  ]
26}