The response codes returned by the Updox API are either 2000s, 4000s, or 5000s. Codes in the 2000s represent a successful response, codes in the 4000s represent a client error, and codes in the 5000s represent a server error. This page outlines all of the 4000, client error, response codes currently in use.
General error codes
| Code
|
Message
|
4000
|
Bad Request
|
4010
|
Unauthorized
|
4011
|
Unauthorized [Practice does not exist or is inactive]
|
4012
|
Unauthorized [User does not exist or is inactive]
|
4013
|
No token found
|
4014
|
Unauthorized
|
4020
|
Bad Request: Request likely too large
|
4060
|
[This code is for a validation error in the request. For example not including a required field, an invalid e-mail address, too long of a value, etc. A list of the errors is included in the message.]
|
4070
|
Invalid recipient
|
4071
|
Recipient not found
|
4072
|
Invalid recipient type, requires PATIENT
|
4073
|
Invalid recipient type, requires CONTACT
|
4074
|
Invalid recipient type, requires PORTAL
|
4075
|
Invalid recipient type, requires DIRECT
|
4076
|
Invalid recipient type, requires EMAIL
|
4077
|
Invalid recipient type, requires FAX
|
4080
|
Recipient unable to receive messages
|
Practice error codes
| Code
|
Message
|
4110
|
no practice ID
|
4130
|
account already exists
|
4131
|
account does not exist
|
4132
|
account already has an accountId
|
4140
|
web address is already taken
|
4150
|
direct domain is already taken
|
User error codes
| Code
|
Message
|
4210
|
no user ID
|
4230
|
user already exists
|
4231
|
user does not exist
|
4232
|
user password is required
|
4233
|
user password is invalid. Password length must be between 8 and 30 characters, contain at least one upper case AND lower case character, and must contain one number OR special character.
|
4240
|
user does not exist; use PracticeUpdate instead
|
4250
|
user dob invalid
|
Contact error codes
| Code
|
Message
|
4330
|
contact already exists
|
4331
|
contact does not exist
|
Message error codes
| Code
|
Message
|
4410
|
message not found
|
4420
|
no actions found
|
4430
|
message type does not have any MDNs
|
Direct address error codes
| Code
|
Message
|
4610
|
direct address error: direct address is taken
|
4620
|
direct address error: domain does not match the direct domain for this account
|
4621
|
direct address error: domain does not match the direct domain for this vendor
|
4630
|
direct address error: account does not have a direct domain configured
|
4640
|
direct address error: invalid direct address
|
4641
|
direct address error: no direct address found for sending user
|
4642
|
direct address error: identity verification required to send to this address
|
4643
|
direct address error: RA/CA information required to provision this address
|
4650
|
direct error: send failed
|
4651
|
direct error: send failed and/or invalid direct address
|
4652
|
direct error: either from or patientDemographics is required
|
Patient error codes
| Code
|
Message
|
4730
|
patient account already exists
|
4731
|
patient account does not exist
|
Portal error codes
| Code
|
Message
|
4830
|
portal account already exists
|
4831
|
portal account does not exist
|
Notification error codes
| Code
|
Message
|
5010
|
at least one notification must be provided
|
5011
|
the maximum number of notifications per request has been exceeded
|
5012
|
at least one id must be specified for the get request
|
