Errors

Customer API Errors

Here are the most common errors you will run into while using the Customer API and how to resolve them. This list is not exhaustive of all possible errors.

Errors	Error Description	Remedy
CUSTOMER_AGE_TOO_HIGH	Field birthday values look too far back.	Enter a valid birthdate that is below the age limit.
CUSTOMER_FIRST_NAME_EMPTY	Field first_name can not be null or empty.	Add a first_name field to the customer profile to get a successful response.
CUSTOMER_FIRST_NAME_TOO_LONG	Field first_name length exceeds the allowed limit of 45 characters.	Use a first_name value less than 45 characters long.
CUSTOMER_GROUP_DUPLICATED_INPUT	The list of entered groups has duplicated values.	The customer_groups cannot contain duplicate groups.
CUSTOMER_LAST_NAME_EMPTY	field last_name can not be null or empty.	Add a last_name field to the customer profile to get a successful response.
CUSTOMER_LAST_NAME_TOO_LONG	Field last_name length exceeds the allowed limit of 45 characters.	Use a last_name value that is less than 45 characters long.
DRIVER_LICENSE_DUPLICATION	Drivers_license is a duplicate of a driver license that already exists in a profile.	Include a unique drivers_license when creating or updating a profile.
DRIVER_LICENSE_EXPIRATION_CANNOT_BE_NULL	drivers_license_expiration is a required datapoint while creating a customer profile.	Include drivers_license_expiration in the format “YYYY-MM-DD”.
DUPLICATED_CUSTOMER_EMAIL	Email is a duplicate of an email that already exists in a profile.	Include a unique email when creating a profile.
DUPLICATED_CUSTOMER_PHONE	Phone number is a duplicate of a phone number that already exists on a profile.	Include a unique phone when creating or editing a profile.
DUPLICATE_ADDRESS_PRIMARY	-	Within each address object, the primary field should be set to true for only one address.
DUPLICATE_ADDRESS_TYPE	-	Do not use the same address type (address_of_record, alternative_address or secondary_address) for more than one address.
FAILED_TO_BUILD_RESPONSE	An unknown exception occurred while processing the request. Contact: [email protected].	If this error is encountered please report it to the API support team([email protected]) in order to get this error investigated.
INDEX_PAGE_MUST_BE_GREATER_THAN_ZERO	-	The page used in the call needs to be greater than 0 in order to get a successful response from the endpoint.
INVALID_ADDRESS_TYPE	Address type should be: address_of_record or alternative_address or secondary_address	In the address array, add a type property with a value of either address_of_record, alternative_address or secondary_address (e.g., "type": "address_of_record")
INVALID_CUSTOMER_GROUP	The entered [customer_group] is wrong. The existing groups are - [customer_groups available in Discount Management > Customer Groups]	Use Customer Groups that exist within Discount Management > Customer Groups.
INVALID_DATE_FORMAT	[Date Used in Query Parameter] date does not match the expected format i.e. yyyy-MM-dd	The date format used was not correct and needs to be adjusted to this format: yyyy-MM-dd.
INVALID_EMAIL	Invalid email format. Must be of format @.	You can get this error if the formatting is incorrect and also if the email does not exist.
INVALID_GENDER	Invalid gender value. Possible values are: M, F, U, N or blank.	Use one of the possible values of M, F, U, N or blank.
INVALID_OPT_OUT	Invalid opt_out value. Possible values are: true, false	Use one of the possible values of true or false
INVALID_PATIENT_TYPE	Invalid patient type value. Possible values are: ADULT, MEDICAL, MEDICAL_MMID	Use one of the possible values of ADULT, MEDICAL, or MEDICAL_MMID.
INVALID_PHONE_NUMBER	-	Enter a valid phone number. The approved format 1234567890
INVALID_USA_STATE	The request includes the state [state entered] which is not a valid USA state. Please correct the data and try again.	Enter a valid 2 letter US state code (e.g., CA, MI, AZ).
LIMIT_MUST_BE_GREATER_THAN_ZERO	Limit must be greater than zero.	The limit set in the endpoint must be greater than 0.
RESPONSE_LIMIT_EXCEEDS	The response limit requested is [Limit selected] which exceeds the maximum response limit. Do not exceed 50.	The limit that is being used in the call needs to be dropped to the maximum allowed.
STATE_MEDICAL_ID_CANNOT_BE_NULL	state_medical_id is required when setting patient_type to MEDICAL_MMID	Include a value for the state_medical_id field when the patient_type is set to MEDICAL_MMID.
USER_NOT_FOUND	Unable to detect the user who made the API request.	If this error is encountered please report it to the API support team([email protected]) in order to get this error investigated.
CUSTOMER_DOESNT_EXIST	-	The Customer ID/Member ID being searched for with this endpoint does not exist. Add a valid Customer ID to get a successful response.
FROMDATE_AFTER_TODATE	-	The fromdate or the start of the time range that is being requested has a later date than the todate or end of the time range. To fix this, adjust the fromdate to a date that is before the todate parameter.
CANNOT_UPDATE_DEACTIVATED_PROFILE	-	Do not update a customer profile that has been deactivated.
CAREGIVER_CUSTOMER_ID_DOES_NOT_MATCH	Entered caregiver_customer_id does not match the existing records. Please use separate endpoint to get the list of all the available caregivers.	Use the correct customer_id for the caregiver.
CUSTOMER_FIRST_NAME_BLANK	Field first_name can not be null or empty.	The customer's first name needs to be present when creating or editing a profile.
CUSTOMER_FIRST_NAME_TOO_LONG	Field first_name length exceeds the allowed limit of 45 characters.	Use a first_name that is less than 45 characters.
MULTIPLE_CAREGIVERS_FOUND	Currently, Treez supports only one caregiver per customer. Please add only one caregiver for now. We'll soon be supporting multiple caregivers.	Only use one caregiver_customer_id value.
REQUIRED_CAREGIVER_LICENSE_NUMBER	caregiver_license_number is a required field when setting the customer as a caregiver. Please correct and try again	Enter a valid caregiver_license_number or remove the customer as a caregiver by changing the value of the is_caregiver field to false.
CUSTOMER_ID_IS_NULL	Customer_id is a required field to upload a document.	Add a customer ID/member id as a query parameter in order to get a successful response
FILES_AMOUNT_EXCEEDED	Maximum allowed files per request is 10	You can only upload 10 files at a time with the customer upload endpoint. Decrease the amount of files to ten or below.
FILE_IS_REQUIRED	base64_data is a required field when file_type or file_name has the value	When uploading a document, the encoded_string field is required and a base 64 encoded string needs to be present.
FILE_NAME_IS_REQUIRED	file_name is a required field	File name is a required field with this endpoint. Add a valid file name in order to get a successful response.
FILE_SIZE_EXCEEDED	The file to be uploaded is too big. The maximum size allowed is 5MB.	Use a file smaller than or equal to 5MB.
INCORRECT_FILE_EXTENSION	Incorrect [file extension] used. File extensions accepted are: gif, .jpg, .jpeg, .png	Use one of the accepted file extensions: gif, .jpg, .jpeg, .png
FILE_TYPE_IS_REQUIRED	file_type is a required field	A file_type is required to get a successful response. The available file_types are: misc_upload, doctor_permit, membership_agreement, and drivers_license.
UNKNOWN_FILE_TYPE	file_type field contains invalid value. Possible values are : .gif, .jpg, .md, .jpeg, .png, .csv, .ppt, .pdf, .txt, .doc	The file type being used is not compatible and needs to change to one of the approved file types listed in the error message.