Errors

Customer API

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.

ErrorsError DescriptionRemedy
CUSTOMER_AGE_TOO_HIGHField birthday values look too far back.Enter a valid birthdate that is below the age limit.
CUSTOMER_FIRST_NAME_EMPTYField 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_LONGField first_name length exceeds the allowed limit of 45 characters.Use a first_name value less than 45 characters long.
CUSTOMER_GROUP_DUPLICATED_INPUTThe list of entered groups has duplicated values.The customer_groups cannot contain duplicate groups.
CUSTOMER_LAST_NAME_EMPTYfield 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_LONGField last_name length exceeds the allowed limit of 45 characters.Use a last_name value that is less than 45 characters long.
DRIVER_LICENSE_DUPLICATIONDrivers_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_NULLdrivers_license_expiration is a required datapoint while creating a customer profile.Include drivers_license_expiration in the format “YYYY-MM-DD”.
DUPLICATED_CUSTOMER_EMAILEmail is a duplicate of an email that already exists in a profile.Include a unique email when creating a profile.
DUPLICATED_CUSTOMER_PHONEPhone 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_RESPONSEAn 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_TYPEAddress type should be: address_of_record or alternative_address or secondary_addressIn 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_GROUPThe 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-ddThe date format used was not correct and needs to be adjusted to this format: yyyy-MM-dd.
INVALID_EMAILInvalid 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_GENDERInvalid 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_OUTInvalid opt_out value. Possible values are: true, falseUse one of the possible values of true or false
INVALID_PATIENT_TYPEInvalid patient type value. Possible values are: ADULT, MEDICAL, MEDICAL_MMIDUse 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_STATEThe 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_ZEROLimit must be greater than zero.The limit set in the endpoint must be greater than 0.
RESPONSE_LIMIT_EXCEEDSThe 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_NULLstate_medical_id is required when setting patient_type to MEDICAL_MMIDInclude a value for the state_medical_id field when the patient_type is set to MEDICAL_MMID.
USER_NOT_FOUNDUnable 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_MATCHEntered 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_BLANKField 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_LONGField first_name length exceeds the allowed limit of 45 characters.Use a first_name that is less than 45 characters.
MULTIPLE_CAREGIVERS_FOUNDCurrently, 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_NUMBERcaregiver_license_number is a required field when setting the customer as a caregiver. Please correct and try againEnter 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_NULLCustomer_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_EXCEEDEDMaximum allowed files per request is 10You can only upload 10 files at a time with the customer upload endpoint. Decrease the amount of files to ten or below.
FILE_IS_REQUIREDbase64_data is a required field when file_type or file_name has the valueWhen uploading a document, the encoded_string field is required and a base 64 encoded string needs to be present.
FILE_NAME_IS_REQUIREDfile_name is a required fieldFile name is a required field with this endpoint. Add a valid file name in order to get a successful response.
FILE_SIZE_EXCEEDEDThe file to be uploaded is too big. The maximum size allowed is 5MB.Use a file smaller than or equal to 5MB.
INCORRECT_FILE_EXTENSIONIncorrect [file extension] used. File extensions accepted are: gif, .jpg, .jpeg, .pngUse one of the accepted file extensions: gif, .jpg, .jpeg, .png
FILE_TYPE_IS_REQUIREDfile_type is a required fieldA 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_TYPEfile_type field contains invalid value. Possible values are : .gif, .jpg, .md, .jpeg, .png, .csv, .ppt, .pdf, .txt, .docThe file type being used is not compatible and needs to change to one of the approved file types listed in the error message.