Developers
Set your API contextPick a region and space ID once. Every sample fills in your base URL.
Where do I find these?

In Coevera: open your space's API application and choose Show Access. It shows the space ID and the base URL, whose host starts with your region.

From the API: if you know the space ID, the discovery endpoint GET /api/discovery/spaces/{space_id} returns its region and base URLs, without credentials.

Only the region and space ID are kept, in this browser. Never paste a key or password here.

More in the quickstart

REST APIError codes

Error codes

Every error code the Coevera CRM API can return, with its name, HTTP status and description, generated from the API's source for each release.

  • 306 error codes
  • 96 with a description
  • API release/6.6.x

Every error body carries success: false, http_status, code, name and message. code and name are stable identifiers; message is for people. Branch on code, not on the HTTP status alone. How to handle them: Errors.

The REST API never answers 403 or 409

A missing permission is HTTP 400 with code 50 (ERROR_NOT_ENOUGH_PERMISSIONS). A revision or data conflict is also 400. Check code, not just the status.

The HTTP column is the status the REST API answers with that code: 404, 422, 429 and 500 for the codes mapped to them, 401 for authentication failures and 400 for every other code. Codes that share a value are listed once, under the name the API sends.

CodeNameHTTPDescription
0NO_ERROR–
1ERROR_CONFLICT_DETECTED400A conflict is detected.
2ERROR_INCORRECT_LOGIN
also ERROR_CLIENT_SPACE_RESET, ERROR_AUTO_LOGOUT
400Incorrect login.
3ERROR_TEAM_SPACE_NOT_ACTIVATED400The team space is not activated.
4ERROR_DATA_COULD_NOT_BE_CONVERTED400The data could not be converted.
5ERROR_INVALID_MESSAGE400Invalid message.
6ERROR_INVALID_TEAM_SPACE_VERSION400Invalid version of team space.
7ERROR_UNKNOWN_VERSION400Unknown version.
8ERROR_ENGINE_FOR_VERSION_NOT_EXISTS400Synchronization engine for this version doesn't exist.
9ERROR_DB_FOR_VERSION_NOT_EXISTS400The database for this version doesn't exist.
10ERROR_USING_HIGHER_VERSION_TO_CS400The client uses higher version than version of team space.
11ERROR_USING_OLDER_VERSION_TO_CS400The client uses older version than team space.
12ERROR_VERSION_UPGRADE_FAILED400Upgrade of team space to higher version failed.
13ERROR_VERSION_UPGRADE_ALREADY_DONE400Upgrade of team space has been already done to selected version
14ERROR_REVISION_ENGINE_HAS_LOCK400
15ERROR_REVISION_ENGINE_HAS_NOT_LOCK400
16ERROR_2FA_FAILED400
17ERROR_UNKNOWN_USER400Login was successful (using 3rd party to verify account), but we don't know this user.
18ERROR_UNEXPECTED_USER400Login was successful (using 3rd party to verify account), but we expected different user.
50ERROR_NOT_ENOUGH_PERMISSIONS400Caller is not authorized to perform action on some Entity.
51ERROR_FEATURE_NOT_ALLOWED400Feature is not available for current user. (Due to Subscription Tier, User Role,...)
52ERROR_FIELD_ACCESS_NOT_ALLOWED400User role restricts Read/Write of entity (custom) field.
53ERROR_FIELD_ACCESS_INVALID_CONDITION400User role does not have permissions to use field in reporting profile filter/group_by...
54ERROR_SHARE_MODE_NOT_ALLOWED400Selected share mode selected is not available for current user. (Due to User Role,...)
100ERROR_TEAM_SPACE_NOT_UNIQUE400Name of team space is not unique.
101ERROR_INCORRECT_VERSION_NUMBER400Unsupported version number.
102ERROR_DATABASE_QUERY400Invalid request. The database is corrupted.
103ERROR_USER_OWNS_OPPTY400
104ERROR_CLIENTS_LIMIT_REACHED400Maximum clients connected to team space reached.
105ERROR_SN_ALREADY_OCCUPIED400The serial number is already occupied.
106ERROR_NO_MORE_LICENSE_SEATS_AVAILABLE400No more license seats are available.
107ERROR_LICENSE_DOES_NOT_EXISTS400License doesn't exist.
108ERROR_SN_NOT_OCCUPYING_LICENSE400Serial number is not occupying license.
109ERROR_LICENSE_ALREADY_EXPIRED400License already expired.
110ERROR_READ_PIPELINE_INIT_FILE400
111ERROR_INVALID_SN400Serial number is invalid.
112ERROR_READING_TEMPLATE_FILE400
113ERROR_CANNOT_CONVERT_USERSPACE_USED400
114ERROR_TRANSACTION_NOT_OPEN400Transaction is not open.
115ERROR_TEAM_SPACE_NOT_EXISTS400Team space doesn't exist.
116ERROR_NOT_IMPLEMENTED400The method is not implemented yet.
117ERROR_PARAMETER_INVALID400Invalid parameter. Type or the value of this parameter is wrong.
118ERROR_PARAMETER_UNKNOWN400Unknown parameter.
119ERROR_PARAMETER_MISSING422Required parameter is missing.
120ERROR_RELATIONS_DOESNT_EXIST400The related object doesn't exist.
121ERROR_CYCLE400You want to set a cycle, which is not allowed.
122ERROR_BATCH400The class cannot be updated or inserted.
123ERROR_LEAD_NOT_FOUND400
124ERROR_LEAD_ALREADY_ASSIGNED400
125ERROR_SALES_UNIT_DOESNT_EXISTS400
126ERROR_CLIENT_DOESNT_EXISTS400
127ERROR_CLIENT_DOESNT_EXISTS_IN_SALES_UNIT400
128ERROR_UNAUTHORIZED_CALL400
129ERROR_NO_LONGER_SUPPORTED400
130ERROR_SN_DISABLED400
131ERROR_CONTRACT_DISABLED400
132ERROR_ACCOUNT_DISABLED400
133ERROR_TEAM_PIPELINE_DOESNT_EXISTS_OR_ACCESS_DENIED400
134ERROR_TEAM_PIPELINE_IS_COMMERCIAL400
135ERROR_SN_DOESNT_EXISTS_OR_ACCESS_DENIED400
136ERROR_INVALID_CONTRACT400
137ERROR_ACCOUNT_DOESNT_EXISTS400
138ERROR_SERIAL_IS_NOT_TEAM400
139ERROR_SIZE_CANT_BE_DETERMINED400
140ERROR_TEAM_SPACE_NO_MORE_SPACE_LEFT400
141ERROR_TIME_OVERLAPPED400The time period overlaps with other period.
142ERROR_CLIENT_EXISTS400The client exists already. You cannot store client with this same username.
143ERROR_NO_ENTITY404The entity doesn't exist. You use method set with wrong<span class=rvts8>ID</span>.
144ERROR_AUTHORIZATION_ENGINE_NOT_AVAILABLE400
145ERROR_CANNOT_CONVERT_USERSPACE_INTEGRATED400
147ERROR_USER_ACCOUNT_DISABLED400
148ERROR_USER_IN_TEAM_PIPELINE_DISABLED400
149ERROR_SUBSCRIPTION_HAS_EXPIRED400
150ERROR_NO_PRIMARY_EMAIL400
151ERROR_NO_PRIMARY_PHONE400
152ERROR_ACC_NO_OWNER400
153ERROR_SCHEMA_CHANGED400
154ERROR_REVISION_ENGINE_IN_READONLY_MODE400
155ERROR_MULTIPLE_RECORDS_FOUND400
158ERROR_DOCUMENT_IS_DELETED_ALREADY400
159ERROR_FORMUPDATE_COMMAND_NOT_RECOGNIZED400
160ERROR_FORGET_PASSWORD_EMAIL_SEND_FAILED400
161ERROR_FORGET_PASSWORD_EMAIL_INVALID400
162ERROR_FORGET_PASSWORD_EMAIL_MISMATCH400
163ERROR_SENDING_MAIL400
164ERROR_TRIAL_EMAIL_EXISTS400
165ERROR_INVALID_EMAIL400Email validation failed, e.g. domain has no MX record.
166ERROR_TEAM_SPACE_TRANSFER400
167ERROR_RELOAD_TOKEN400
168ERROR_CHANGES_ARE_BG_SYNC_NOT_COMPATIBLE400
169ERROR_CLEANING_DUMP400
170ERROR_DUMPING_DB400
171ERROR_NOT_DELETABLE400
172ERROR_CALC_BAD_FORMULA_SYNTAX400
173ERROR_CALC_CIRCULAR_REFERENCE400
174ERROR_CALC_DIVIDED_BY_0400
175ERROR_CALC_INVALID_REFERENCE400
176ERROR_CALC_WRONG_TYPE400
177ERROR_CALC_NO_VALUE400
178ERROR_EMAIL_EXISTS400
180ERROR_CALC_FORMULA_NOT_ALLOWED400
181ERROR_TRANSACTION_OPEN400
182ERROR_TOO_MANY_REQUESTS429
183ERROR_CLIENT_DISCONNECTED400
184ERROR_METHOD_DO_NOT_EXISTS400
185ERROR_INVALID_VERSION_MODEL400
186ERROR_TOO_MANY_CHANGES_FOR_SYNC400
187ERROR_CALC_VALIDATION_FAILED400Parameter did not pass user defined validation.
188ERROR_INTEGRATION_FAILED400
189ERROR_NOT_ALLOWED_TO_USE_MOBILE400
190ERROR_UNEXPECTED_RESPONSE400
191ERROR_BROKEN_SYNC_MODEL400
192ERROR_FK_NOT_FOUND400
193ERROR_PARAMETER_INVALID_MIN_STEPS400Invalid parameter. Minimum three steps per Pipeline.
194ERROR_PARAMETER_INVALID_MAX_STEPS400Invalid parameter. Maximum thirty steps per Pipeline
195ERROR_PARAMETER_INVALID_TO_ADDRESS400Invalid parameter. "To" header is not valid
196ERROR_HYBRID_SPACE_IS_REQUIRED400Invalid parameter. Only relations to hybrid spaces are allowed.
197ERROR_ALREADY_IN_PROGRESS400Processing is already in progress.
198ERROR_SIMULTANEOUS_UPDATE400Trying to update entity that was already updated by other user
199ERROR_NO_PIPELINE_ACCESS400Owner has no access to specified Pipeline.
205ERROR_CLIENTSPACE_NAME_INVALID400
206ERROR_CLIENTSPACE_NAME_EMPTY400
207ERROR_POSITION_ALREADY_EXISTS400
208ERROR_HAS_CHILDS400
209ERROR_MUST_HAVE_AT_LEAST_ONE_SU400
210ERROR_CLIENTSPACE_UPGRADE_ERROR400
211ERROR_NO_ROW_UPDATED400
212ERROR_ATTRIBUTE_NOT_UNIQUE400Attribute must be unique.
213ERROR_UPDATE_NOT_ALLOWED400Attribute is not allowed on update.
214ERROR_PRIMARY_IS_NOT_SET400Primary entity is not set.
215ERROR_DUPLICATE_RELATION400Each relational entity must be unique.
216ERROR_MINITEMS_REQUIRED400Multiple choices are required to set in list.
217ERROR_TEAM_SPACE_UNDER_MAINTENANCE400Space is disabled for maintenance
219ERROR_NOT_DIRECT_RELATION400Used in unlink when relation is not direct
220ERROR_OCCUPIED_SCHEDULER_URL400Used appointment scheduler url is already taken
221ERROR_FORBIDDEN_EXTENSION400File extension is forbidden
222ERROR_REMOTE_FILE_NOT_FOUND400
223ERROR_REQUIRED_CALC_FORMULA_EMPTY400Calc formula on field is required - but was empty
224ERROR_APPROVAL_PROCESS_ENTITY_BLOCK400Creation of won/accepted entity is blocked when approval process with process management checked is evaluated
225ERROR_REQUEST_TOO_LONG400
226ERROR_QUOTA_EXCEEDED400
227ERROR_INCORRECT_LICENSE_COUNT400Request was canceled on db connection
228ERROR_REQUEST_CANCELED400Wrong license count is used.
300ERROR_REGISTRATION_FAILED400
301ERROR_DB_SOME_ERROR400Database error occurred operation isn’t completed.
302ERROR_LEAD_AUTHORIZATION_FAILED400
400ERROR_INVALID_POST_PARAMS400
401ERROR_UNAUTHORIZED401
402ERROR_TEAM_SPACE_NOT_ACTIVE400
403ERROR_OLD_ENTITY_REVISION400Revision of entity is old. Try reload entity.
404ERROR_INVALID_ENTITY_REVISION400Revision is corrupted or wrong.
405ERROR_TEAM_SPACE_DELETED_BY_CLEANUP400Team space was deleted by automatic cleanup.
406ERROR_TEAM_SPACE_IN_DIFFERENT_REGION400Team space called in wrong region.
407ERROR_INVALID_OPERATION400
450ERROR_DATA_INTEGRITY400
460ERROR_MISSING_SCHEMA400Missing schema (used in process builder - process must contain schema when enabling)
461ERROR_INVALID_SCHEMA400Invalid schema (used in process builder - validates specific constraints for schema)
462ERROR_PROCESS_HAS_SCHEDULED_ACTIONS400Used on process deactivation, when process has scheduled actions.
463ERROR_SCHEDULED_ACTION_ALREADY_FINISHED400Scheduled action was already finished.
464ERROR_NOT_VALID_PROCESS_TRIGGER_TYPE400Process is not valid trigger type.
465ERROR_ENTITY_TOO_LARGE400Entity is too large
466ERROR_APPOINTMENT_DATE_NOT_AVAILABLE400
467ERROR_EMAIL_SEQUENCE_INACTIVE400Tried to send/enroll into an email sequence that is not active (disabled or deleted).
500ERROR_WRITE_LOCK_NOT_OBTAINED400
501ERROR_USER_LOCK_NOT_OBTAINED400
601ERROR_NOT_FOUND400
602ERROR_ALREADY_EXISTS400
700ERROR_TOO_MANY_ORDER_RELATED_DOCUMENTS400Order related documents CANNOT be part of the order.
701ERROR_UNSUPPORTED_ORDER_STATUS400Order CANNOT be completed or cancelled.
1000ERROR_UNKNOWN500Unexpected programming error. ErrorCode.ERROR_UNKNOWN means unhandled exception for us, its supposed to be raised by top level error handlers, replacing the unexpected unknown error that programmer has not think of. Therefore is logged as critical and shows up in sentry, which allows to improve lower level handlers by catching specific errors.
1337ERROR_EASTER_EGG_FOUND418
2000ERROR_SERVER_API400
2001ERROR_CHILD_EXISTS400
2002ERROR_CONFLICTING_DATA400You cannot delete the entity, because it is used.
2003ERROR_ENTITY_IS_USED400Parent or some child is used
2005ERROR_TOO_MANY_STAGES400The maximum of stages can be 7.
2006ERROR_UNKNOWN_TYPE404
2007ERROR_NUMBER_EXCEEDED400The number of something is exceeded.
2008ERROR_TIME_EXPIRED
also ERROR_SESSION_EXPIRED
400The timestamp is older. Email was not sent in allowed time window,...
2009ERROR_FIELD_EXISTS400The field cannot be shared, because it exists in other entity.
2010ERROR_FORM_UNKNOWN400The server cannot processed a form on field. Check the syntax, or is used unknown function.
2011ERROR_TERMS_CONDITIONS_NOT_ACCEPTED400
2012ERROR_3RD_PARTY_AUTH_FAILED400
2013ERROR_INCORRECT_PASSWORD400
2014ERROR_TOO_MANY_CUSTOM_FIELDS400
2015ERROR_UNAVAILABLE_COMPANY_EMAIL400
2016ERROR_UNAVAILABLE_COMPANY_EMAIL_SERVICE400
2017ERROR_REVENUE_SCHEDULE_INVALID_TRANSFORMATION400
2018ERROR_EMAIL_UNSUBSCRIBED400
2019ERROR_INVALID_ROLLUP_CONFIGURATION400
2020ERROR_INVALID_ROLLUP_NESTING400
2021ERROR_FIELD_FORM_PUBLISH_INVALID_CONFIGURATION400
2022ERROR_EMAIL_NOT_SHARED400
2023ERROR_EMAIL_NOT_VERIFIED400
2024ERROR_EMAIL_DRAFT_ALREADY_SENT400The draft referenced by `draftId` was already promoted to a real message (sent or scheduled) by someone else — the caller's local copy is stale and the Send/Schedule cannot proceed.
2025ERROR_EMAIL_DRAFT_ALREADY_EXISTS400Another draft replying to the same parent email already exists in the target mailbox. Each (parent, mailbox) pair can have at most one draft child; SaveEmailDraft refuses to create or move a draft into a slot that's already occupied.
2026ERROR_INVALID_LAST_CONTACTED_DATE_NESTING400The Last Contacted Date custom definition (or a rollup) forms a field-dependency cycle through the Last Contacted Date field — the chosen definition references Last Contacted Date again, directly or transitively. Analogous to ERROR_INVALID_ROLLUP_NESTING.
2100ERROR_PENDING_PARTNER_EXISTS400
2101ERROR_APPROVED_PARTNER_EXISTS400
2102ERROR_REJECTED_PARTNER_EXISTS400
2103ERROR_ORDER_OVERPAYMENT400
2110ERROR_INSUFFICIENT_CREDIT400
2111ERROR_INCORRECT_PAYMENT_AMOUNT400
2112ERROR_INCORRECT_COUNTRY400
2113ERROR_INCORRECT_STATE400
2114ERROR_MISSING_COUNTRY400
2115ERROR_MISSING_STATE400
3000ERROR_ROLLUP_FILTER_CONTAINS_NOT_ACCESSIBLE_FIELD400
3001ERROR_ROLLUP_SUMMARIZE_FIELD_NOT_ACCESSIBLE400
3002ERROR_ROLLUP_SUMMARIZE_FIELD_IS_DELETED400
3003ERROR_ROLLUP_RELATION_DELETED400
3004ERROR_ROLLUP_INSUFFICIENT_MASTER_RIGHTS400
3005ERROR_ROLLUP_FILTER_CONTAINS_DELETED_FIELD400
3006ERROR_ROLLUP_SORTING_FIELD_IS_DELETED400
3007ERROR_ROLLUP_SORTING_FIELD_NOT_ACCESSIBLE400
3100ERROR_SMART_FIELD_UNKNOWN_ERROR400
3101ERROR_SMART_FIELD_KNOWN_ERROR400
3102ERROR_SMART_FIELD_NO_SOURCE_DATA_ERROR400
3103ERROR_SMART_FIELD_REQUEST_NOT_UNDERSTOOD_ERROR400
3104ERROR_SMART_FIELD_NO_RESULT_ERROR400
3203ERROR_CONNECTION_FAILED400
3204ERROR_ATTACHMENT_UPLOAD_FAILED400
3205ERROR_AUTODISCOVERY_FAILED400
3206ERROR_CALLING_NO_PERSONAL_VOIP400
3207ERROR_CALLING_GEO_RESTRICTED400
3208ERROR_INVALID_DOMAIN400
3209ERROR_UNSUPPORTED_FILE400
3210ERROR_TOO_MANY_FILES400
3211ERROR_INTERPOLATION_MISSING400
3212ERROR_MISMATCH400
3213ERROR_INVALID_PRICE_LIST400
3401ERROR_CALC_FORMULA_RUNTIME_DIVISION_BY_ZERO400
3402ERROR_CALC_FORMULA_RUNTIME_GENERAL_ERROR400
3403ERROR_CALC_FORMULA_RUNTIME_INVALID_DATETIME400
3404ERROR_CALC_FORMULA_RUNTIME_INVALID_NUMBER400
3405ERROR_CALC_FORMULA_RUNTIME_INVALID_TEXT400
3406ERROR_CALC_FORMULA_RUNTIME_FIELD_ACCESS_NOT_ALLOWED400
3407ERROR_CALC_FORMULA_RUNTIME_FIELD_IS_DELETED400
4000ERROR_EXPORT_IS_RUNNING400
4001ERROR_EXPORT_HAS_FAILED400
4002ERROR_EXPORT_NOT_FOUND400
4441ERROR_CALC_UNKNOWN_SYNTAX400
4442ERROR_CALC_MISSING_OPERATOR_REFERENCE400
4443ERROR_CALC_UNMATCHED_PARENTHESES400
4444ERROR_CALC_UNDEFINED_FIELD_INDEX400
4445ERROR_CALC_AMBIGUOUS_OPERATION_ORDER400
5000ERROR_ASSERT400
6000ERROR_IMAP_HOST_UNREACHABLE400
6001ERROR_IMAP_INCORRECT_LOGIN400
6002ERROR_IMAP_FOLDER_LIST_ERROR400
7000ERROR_EXCHANGE_AUTODISCOVER_FAILED400
7001ERROR_EXCHANGE_LOGIN_FAILED400
7002ERROR_EXCHANGE_UNREACHABLE_FAILED400
7003ERROR_EXCHANGE_UNSUPPORTED400
8000ERROR_REPORT_IS_TOO_LARGE400
8001ERROR_REPORT_HAS_EXPIRED400
8002ERROR_REPORT_DEFINITION400
8003ERROR_REPORT_INCOMPATIBLE_TYPE400
8004ERROR_REPORT_EMPTY400
8005ERROR_REPORT_LAMBDA_ERROR400
8006ERROR_REPORT_IS_TOO_LARGE_LAMBDA_ERROR400
8101ERROR_EMAIL_REFRESH_RESULT_TOO_LARGE400emailListRefreshedData diff exceeds config.email_refresh_diff_max_items.
9001ERROR_JSON_FORM_INVALID400
9002ERROR_JSON_FORM_PARENT_DATASET_MISSING400
20051ERROR_TRANSCRIPTION_ERROR400
20052ERROR_TRANSCRIPTION_EMPTY400
20053ERROR_TRANSCODING_ERROR400
20054ERROR_UPLOAD_ERROR400
20055ERROR_AUDIO_TOO_LONG400
40000ERROR_ENTITY_VALIDATION422Structured error of all failed Entity validations, with detailed information about fields.
40001ERROR_NO_ACCESS_FOR_REQUIRED_FIELD400Create/Update action because the used can't fill in required field, due to restricted field permissions.
40002ERROR_FIELD_VALIDATION400Structured error of all failed field validations, with detailed information about error.
40003ERROR_STEP_CHECKLIST_VALIDATION400Structured error of all failed step checklist validations, with detailed information about error.
50001ERROR_JOB_EXISTS400
50002ERROR_JOB_NOT_FOUND400
50003ERROR_JOB_NOT_FINISHED_YET400
50004ERROR_JOB_RESULT_FAILURE400
50005ERROR_JOB_RESULT_NOT_EXISTS400
50006ERROR_JOB_PROCESS_FAILURE400
50007ERROR_JOB_CONTAINS_RUNNING_WORKER400
50008ERROR_INVALID_GATEWAY_SERVICE400
50009ERROR_INVALID_GATEWAY_METHOD400
50010ERROR_INVALID_GATEWAY_REQUEST400
50011ERROR_3RD_PARTY_API_ERROR400
50012ERROR_3RD_PARTY_API_TOKEN_EXPIRED400
50013ERROR_3RD_PARTY_API_PERMISSION_DENIED400
50014ERROR_3RD_PARTY_API_ERROR_AUTHORIZATION_FAIL400
50015ERROR_3RD_PARTY_API_UNSUPPORTED400
50016ERROR_3RD_PARTY_API_UNAVAILABLE400
50017ERROR_3RD_PARTY_API_THROTTLING400
50018ERROR_3RD_PARTY_API_LIST_LIMIT400
50019ERROR_3RD_PARTY_API_ACCOUNT_LIMIT400
50020ERROR_3RD_PARTY_QUOTA_EXCEEDED400
50021ERROR_3RD_PARTY_RESOURCE_LIMIT_EXCEEDED400
50022ERROR_3RD_PARTY_INSUFFICIENT_SCOPES400
50023ERROR_3RD_PARTY_NOT_VERIFIED400
50024ERROR_AI_FEEDS_SUMMARY_TOO_LARGE400
50025ERROR_ACCOUNT_LIMIT_EXCEEDED400
50026ERROR_AI_GUARDRAILS_BLOCKED400
50027ERROR_AI_INVALID_PROMPT400
50028ERROR_LAMBDA_TIMEOUT400
50029ERROR_AI_REQUEST_BLOCKED400
50030ERROR_PROMPT_TOO_LONG400
50031ERROR_AI_CREDIT_LIMIT_EXCEEDED400AI credit overage limit exceeded for this subscription.
58100ERROR_INTEGRATION_DISABLED_BY_USER400
58101ERROR_RETRY_FAILED400A manual retry (e.g. start_full_sync) could not be started - there is nothing to retry.