Common Contact API Errors
Common errors when using the Drift Contacts API
We have a standard list of errors, and corresponding error codes, that you may receive when using the contacts API:
| Contact Error Code | HTTP Status | Description |
|---|---|---|
| CONTACT-1 | 404 | Unauthorized to view contact or not found. |
| CONTACT-2 | 401 | Unauthorized to view contact or not found. |
| CONTACT-4 | 400 | Malformed contact: Bad http payload construction for updating or creating a new contact. |
| CONTACT-5 | 500 | Drift had an unexpected issue processing the request, perhaps check the payload body for formatting or bad field values. |
| CONTACT-6 | 409 | Conflict when creating contact. Typically results from a contact already existing with a given id. |
| CONTACT-7 | 400 | Attempted to create a contact without email. |
| CONTACT-8 | 400 | Attempted to create or update contact without attributes |
| CONTACT-9 | 400 | Bad format of contact tags in payload. Common case is that a provided tag name didn't map to known a know tag id. |
| CONTACT-10 | 400 | Unrecognized query parameter |
| CONTACT-11 | 400 | Generic Bad Request from contact service. Includes custom message. |
Error code CONTACT-3 has been deprecated.
Error codes above are not exhaustive
Note you may encounter other errors from the contacts API, but these are typically from other malformed requests, or the API call failed prematurely. These will typically result in 400 responses with other error messages.
Updated over 5 years ago