Table of contents
Typically it is fairly easy to troubleshoot the User Profile within Iterable.
You will just want to ensure that the correct
- You can store a soft limit of 1,000 user parameters on your user profiles
- If you are only identifying the user on the
IterableAPI.userIdcall, then Iterable assumes you do not know the email of the user yet and will create a placeholder email called
userId+hashValue@placeholder.email. We will discuss in the next section how we can update the email of an unkown user.
You will also want to confirm:
- You are using the correct
- You do not have any duplicate
IterableAPI.email = "firstname.lastname@example.org"calls.
- You have the correct API key for that project.
- That API key has
To verify is the user profile is being generated and set with relevant information, go to Audience > Contact Lookup > Enter Test Email Address and search. This should return a user profile with email address and userId (if set).
1. Navigate to Contact Lookup
2. Look up your specific user
User profile not found in Iterable
Make sure you are looking in the correct project, user profiles created and updated with sandbox project won't appear in productions and vice versa.
Make sure you are setting an email after Iterable SDK is initiated.
Update user profile is failing
We recommend using email id as primary key when updating user's profile. If you use userId as a primary key to update user'r profile, you may run into duplicate record error.
dataTypeMismatch while updating user profile
This error occurs when you pass a different data format for an existing field. Make sure all your data formats match when making an update user profile call.
Invalid API key
Verify that your API key is valid. For more information about API keys, read API Keys.
Error:4XX email already exists
You'll see this error when you make a
call and propose a new email address that already exists on another user profile
in your Iterable project.
Duplicate users in Iterable
This can happen when apps aren't synchronized with updated user profile. When a user updates their email address on web app, this will update a current user with with an updated email address. If user's mobile app is not sychronized to get updated user profile, when user accesses mobile app later, register device token can create a new user with old email address.
Make sure you are not calling register device token method on outdated email address.