Error codes
A 400 response carries one or more four-digit error codes in the RequestError
envelope. This page lists every code. It is generated from the API reference, so it always matches what the API
publishes.
{
"errors": [{ "0066": "Neplatný zľavový kód" }],
"request_valid": false
}
- Branch on the code, never on the message. A code never changes meaning. Messages are written for people: they come in the company's language and their wording may change. The English messages below are for reference only.
- Some codes name a value. The table says which, and where to find it:
- The value ends the message, after
-, or in place of a placeholder:{"0037": "Neplatná hodnota parametra - rate_tier"}. - The value comes under key
0, next to the code:{"0074": "…", "0": "…"}.
- The value ends the message, after
- Codes aren't tied to particular operations. General codes such as
wrong_parameters_sent,resource_not_found,invalid_valueandupdate_failedcan come from almost any operation, so handle codes you didn't expect.
Link to a single code with /api/error-codes#<code>, for example #0065.
A code that isn't clear, or one you think is returned by mistake? Ask usNever send your client_secret or an access token.
319 codes
Requests and validation (34)Authentication and access (22)Users and people (36)Bookings (32)Sessions and attendance (21)Programmes and classes (9)Communication (11)Integrations (61)Files and documents (2)Other (9)Payments (54)Invoicing (18)Direct debit (10)
Requests and validation
| Code | Name and meaning | English message |
|---|---|---|
0001 | wrong_versionReturned when the request targets an API version that does not exist. | |
0004 | invalid_methodReturned when the HTTP method is not supported for the endpoint, or is not one of GET, POST, PUT or DELETE. | |
0005 | resource_missingReturned when the record addressed by the request (for example by its id in the path) does not exist or is not available to your company. Check the id. | |
0017 | bad_emailReturned when an email address is missing, malformed or known to be undeliverable, for example on booking, sign-in or a user update, or when messaging a client whose email bounces. | |
0022 | email_missingReturned when an email address is required (for example for the booking's client or buyer) but none was sent. | |
0025 | bad_datetimeReturned when a date or time in the request (for example a scheduled send time for a message) cannot be parsed. The message ends with the refused value. The value ends the message. | |
0031 | update_failedReturned when a change could not be saved, for example because the record is in a state that does not allow it or the save itself failed. The message ends with detail about what failed. The value ends the message. | |
0033 | wrong_parameters_sentReturned when required parameters are missing or have the wrong shape or value. The message ends with the parameter or detail that was refused. The value ends the message. | |
0037 | invalid_valueReturned when a parameter is present but its value is not allowed. The message ends with the field or detail that was refused. The value ends the message. | |
0039 | nothing_to_updateReturned when an update request contains no changes compared with the stored data. | |
0046 | deleting_failedReturned when a record could not be deleted, for example because it is still in use or the delete failed. Some responses end the message with detail about what failed. | |
0062 | sub_resource_not_foundReturned when a linked item (such as a file or URL attached to a programme, class, session or booking) cannot be found. The message ends with the type of item. The value ends the message. | |
0063 | relation_already_existReturned when trying to attach an item (such as a file, URL or product) that is already attached. | |
0064 | delete_failedReturned when a record could not be deleted, for example because it is still in use. Some responses end the message with detail about what failed. | |
0065 | resource_not_foundReturned when a record referenced by the request does not exist or does not belong to your company. The message ends with the type of record that was not found. The value ends the message. | |
0068 | insert_failedReturned when a new record could not be created. The message may end with detail about what failed. | |
0085 | not_deletedReturned when you try to restore a session, class, programme or booking that is not deleted. | |
0086 | not_restorableReturned when a deleted session, class or booking cannot be restored because it was deleted before restoring was supported. | |
0087 | restore_window_expiredReturned when you try to restore a deleted item (session, class, programme, booking or scheduled payment) after the 30-day restore window has passed. | |
0101 | invalid_status_transitionReturned when an item cannot move to the requested status from its current one, e.g. changing a to-do to a status not allowed from its current status, or deleting or restoring a scheduled payment that is not in a deletable or restorable state. | |
0169 | invalid_value_typeReturned when a custom metadata field is created with an unsupported value type, or a metadata value does not match its field's type (string, int, bool or JSON). | |
0170 | metadata_key_immutable_typeReturned when you try to change the value type of an existing custom metadata field; the type cannot be changed after creation. | |
0171 | metadata_key_duplicate_nameReturned when you rename a custom metadata field to a name another field in your company already uses. | |
0210 | invalid_export_typeReturned when an export is requested with an unknown export type. | |
0211 | export_type_not_supportedReturned when the requested export type is recognised but cannot be produced yet. | |
0213 | invalid_emailReturned when an email address in the request is not valid, e.g. a shared-link recipient or a contact's email. The message carries the offending address or the field name. The value ends the message. | |
0219 | view_config_invalidReturned when a saved view's configuration is malformed or contains an unknown setting. The message carries the name of the refused setting. The value ends the message. | |
0220 | view_config_too_largeReturned when a saved view's configuration exceeds the maximum allowed size. | |
0221 | export_format_invalidReturned when a view or report export is requested in an unsupported file format. | |
0222 | export_too_largeReturned when a view or report export would contain more rows than the allowed maximum. Narrow the filters and try again. | |
0223 | view_type_not_exportableReturned when exporting a view whose type does not support export. | |
0235 | invalid_domain_nameReturned when a domain submitted for card-payment wallets or for video embedding is not a valid domain name. | |
0264 | missing_parametersReturned when required fields are missing from the request, e.g. when creating or updating a contact or a session note. | |
0346 | custom_customer_id_unknown_tokenReturned when the custom client ID template contains an unknown tag. The message ends with the unknown tag. The value ends the message. |
Authentication and access
| Code | Name and meaning | English message |
|---|---|---|
0002 | api_key_missingReturned when the request carries no credentials. | |
0003 | api_key_invalidReturned when the API key is not recognised or cannot be used for this request. The message ends with the key that was sent; check it is correct and active. The value ends the message. | |
0006 | auth_token_missingReturned when the operation needs a signed-in user and the request carries none. | |
0007 | user_not_logged_inReturned when the endpoint requires a signed-in user and the token sent is missing, invalid or expired. Sign in again and retry with a fresh token. | |
0008 | low_permissionsReturned when the signed-in user or API key is not allowed to perform this action or access this record, for example because of its role or because the record belongs to someone else. | |
0018 | action_token_expiredReturned when a one-time verification or authorisation token (for example from an email link) has expired, or when a connected service's authorisation has been revoked. Request a new link or reconnect. | |
0023 | action_token_not_foundReturned when a one-time verification token (for example from an email link) does not exist or was issued for a different action. Request a new link. | |
0055 | invalid_companyReturned when the requested company is not accessible to the user, is inactive, or does not own the record being accessed. | |
0076 | invalid_account_statusReturned when the company's account is not yet verified (or is otherwise restricted) and the action, such as sending custom or bulk emails, importing or emailing exports, is not allowed yet. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0172 | unknown_userReturned when a login is rejected, or no Zooza user exists for the authenticated email address. | |
0178 | company_inactiveReturned for any request made to a company whose Zooza account is no longer active. | |
0194 | signup_rate_limitedReturned when too many sign-up attempts come from the same IP address. Wait before trying again. | |
0241 | login_rate_limitedReturned when too many login or sign-in attempts were made from the same address or for the same contact. Wait and try again later. | |
0242 | invalid_contactReturned during client login when the entered contact is neither a valid email address nor a valid phone number. | |
0243 | contact_channel_unavailableReturned when a login code cannot be sent to the given contact, e.g. the channel is not supported or the phone number does not match exactly one client. | |
0356 | passkey_not_availableReturned when passkey login is not available in this context. Log in with a one-time code instead. | |
0357 | passkey_domain_mismatchReturned when a passkey is used on a website it was not registered for. Log in with a one-time code instead. | |
0358 | passkey_challenge_expiredReturned when the passkey challenge is missing, already used or expired. Start the passkey login or registration again. | |
0359 | passkey_not_recognizedReturned when the passkey presented is not registered to any account. Log in with a one-time code instead. | |
0360 | passkey_verification_failedReturned when the passkey response cannot be verified. Try again or log in with a one-time code. | |
0361 | passkey_already_registeredReturned when registering a passkey that is already saved to the account. | |
0364 | api_key_not_entitledReturned when creating or configuring an API key with an option the company's Zooza plan does not include. The message ends with the refused option (for example the tier, scope or group). The value ends the message. |
Users and people
| Code | Name and meaning | English message |
|---|---|---|
0009 | no_user_foundReturned when a booking or reservation cannot proceed because the client it refers to could not be found or created. | |
0014 | create_user_no_emailReturned when creating a client or user without an email address. Provide an email. | |
0015 | create_user_db_errorReturned when a new client or user could not be saved. Retry, and contact support if it persists. | |
0016 | create_user_bad_emailReturned when creating a client or user with an email address that is not in a valid format. | |
0038 | email_already_registeredReturned when changing a user's email to an address that is already used by another account. | |
0080 | last_owner_cannot_change_roleReturned when the only remaining owner of the company tries to change their own role. Add another owner first. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0084 | buyer_person_not_assignedReserved for when a booking has no buyer person assigned. Not currently returned. | |
0173 | relationship_already_existsReturned when you create a relationship between two people that already exists. | |
0174 | relationship_self_referenceReturned when you try to create a relationship between a person and themselves. | |
0175 | relationship_target_missingReturned when the other person in a new relationship does not exist in your company. | |
0176 | relationship_type_invalidReturned when the relationship category and type sent do not match a known relationship type. | |
0177 | relationship_creation_failedReturned when a relationship between two people could not be saved. | |
0180 | user_already_in_companyReturned when you invite someone as staff who already has a staff role in your company. | |
0262 | person_not_foundReturned when a participant or buyer referenced in a booking or order cannot be matched, e.g. the id does not exist or does not belong to the signed-in client. | |
0263 | cant_create_personReturned when a new participant could not be created while processing a booking. | |
0278 | contact_field_key_invalidReturned when a contact custom field key is invalid: use lowercase letters, digits and underscores, starting with a letter. The message carries the refused key. The value ends the message. | |
0279 | contact_field_key_existsReturned when creating a contact custom field with a key that already exists. The message carries the key. The value ends the message. | |
0280 | contact_field_not_foundReturned when a contact refers to a custom field that does not exist. The message carries the field key. The value ends the message. | |
0281 | contact_field_type_change_forbiddenReturned when trying to change the key or type of an existing contact custom field. The message names the refused property. The value ends the message. | |
0282 | contact_form_invalid_settingsReturned when contact form settings are invalid. The message carries the path of the refused setting. The value ends the message. | |
0283 | contact_email_existsReturned when creating or updating a contact with an email address another contact already uses. | |
0284 | contact_email_requiredReturned when converting a contact to a client and the contact has no email address. | |
0285 | contact_already_clientReturned when converting a contact that is already linked to a client. | |
0286 | contact_form_origin_not_allowedReturned when a contact form is submitted from a website that is not allowed for that form. | |
0287 | contact_form_default_cannot_be_archivedReturned when trying to archive the company's default contact form. | |
0298 | claim_already_openReturned when an email verification (identity claim) is already pending for this person. Wait for it to be confirmed or cancel it first. | |
0299 | identity_claim_not_confirmableReturned when an email verification can no longer be completed or cancelled, for example because it expired, was cancelled, or the target account changed. | |
0300 | person_has_no_identityReturned when a person without an email address is asked to become the account holder or buyer. Add an email address to the person first. | |
0301 | identity_change_not_allowedReturned when you try to change the login email of a person who already has one. The login email cannot be changed through this operation. | |
0302 | owner_requiredReturned when someone other than the account owner tries to manage email verifications or promote a person to account holder. | |
0303 | no_registrations_selectedReturned when promoting a person to account holder without selecting any of their bookings to move. Select at least one booking. | |
0313 | availability_days_invalidReturned when some days in an instructor's availability are not valid. The response lists the failing days with a reason for each. | |
0314 | availability_batch_wrong_stateReturned when an instructor availability change is not allowed in the availability's current state, for example it was already submitted or approved. Reload and try again. | |
0315 | return_comment_requiredReturned when instructor availability is returned to the instructor without a comment explaining why. | |
0316 | availability_span_invalidReturned when an instructor availability period ends before it starts or spans more than 31 days. | |
0365 | create_user_already_existsReturned when creating a user with an email address that already belongs to an existing user. |
Bookings
| Code | Name and meaning | English message |
|---|---|---|
0010 | already_registeredReturned when the client already has an active booking for this programme, class or session. | |
0013 | cant_create_registrationReturned when a booking could not be created, for example because the submitted data was incomplete or the booking could not be saved. | |
0020 | online_registration_disabledReturned when online booking is switched off for this programme or class. | |
0021 | unknown_registration_typeReturned when the booking request is made against a programme whose booking type does not support this operation. | |
0024 | already_requestedReturned when the client already has a pending booking request for this programme or class and no way of resolving the conflict was chosen; also when a one-off notification has already been sent. | |
0034 | first_name_missingReturned when a booking is submitted without the client's first name. | |
0035 | last_name_missingReturned when a booking is submitted without the client's last name. | |
0036 | phone_missingReturned when a booking is submitted without a phone number and the programme requires one. | |
0041 | registrations_cap_reachedReturned when the class or programme has reached the maximum number of bookings allowed. | |
0053 | min_personsReturned when a booking includes fewer participants than the class requires, or no participant list. Add participants. | |
0054 | max_personsReturned when a booking includes more participants than the class allows. Remove participants. | |
0056 | schedule_startedReturned when booking a class that has already started and the programme asks the client to confirm a late booking. Repeat the request with the late booking confirmed. | |
0058 | registration_not_foundReturned when the booking referenced by the request does not exist or is not accessible. | |
0078 | trial_registration_exists_in_scheduleReturned when the client already has a trial booking in this class. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0079 | share_link_expiredReturned when a booking or verification uses a private access link that has expired or been disabled. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0081 | event_full_trialReturned when booking a trial session that has no free places left. Choose another session. | |
0083 | buyer_data_not_foundReserved for when the buyer details of a booking cannot be found. Not currently returned. | |
0246 | glued_session_fullReturned when a booking is refused because the linked sessions shared between classes have no free places for the requested number of seats. | |
0247 | start_date_not_availableReturned when a booking requests a later start date that is not available for the class. Choose another start date or join the waiting list. | |
0248 | priority_window_closedReturned when booking a class that is open only for priority registration and the priority window is not open now. | |
0249 | priority_not_eligibleReturned when booking a class during its priority registration window and the client is not an eligible existing client. | |
0297 | already_registered_openReturned when a client tries to book a pay-as-you-go class they already have a booking in. Log in to book a session, or explicitly ask for a new booking. | |
0326 | purchase_limit_reachedReturned when the client has already bought this item the maximum number of times allowed. | |
0327 | entry_pass_requires_payment_planReturned when a client tries to buy an entry pass pack outright that is only offered with a payment plan. Choose a payment plan for the purchase. | |
0329 | service_item_requires_scheduleReturned when a service priced per session or per day is ordered without a class. | |
0331 | linking_rule_brokenReturned when linking bookings together, or removing a linked booking, would break a booking-linking rule. The message ends with the code of the broken rule. The value ends the message. | |
0332 | linking_decision_missingReturned when a booking-linking change needs an explicit choice that was not sent. The message ends with the code of the rule that needs the decision; send the choice and retry. The value ends the message. | |
0333 | linking_root_has_membersReturned when you try to cancel or delete a booking that other bookings are linked under. Handle the linked bookings first. | |
0336 | cancellation_reason_category_needs_oneReturned when a change to cancellation reasons would leave a category without any active reason. Keep at least one active reason per category. | |
0337 | cancellation_reasons_network_enforcedReturned when a company tries to change cancellation reasons that its network manages and enforces. | |
0338 | cancellation_reason_requiredReturned when a booking is cancelled without a cancellation reason and the company requires one. | |
0339 | cancellation_reason_invalidReturned when the cancellation reason sent is unknown or not active for this company. Choose another one. |
Sessions and attendance
| Code | Name and meaning | English message |
|---|---|---|
0011 | event_fullReturned when the session has no free places left, for example when booking a make-up or additional session. Choose another session. | |
0012 | could_not_create_eventReturned when a session could not be created. Not currently returned by the API. | |
0032 | cancellation_limit_reachedReturned when a client tries to cancel attendance at a session after the cancellation deadline. The message ends with the deadline date and time. The value ends the message. | |
0043 | could_not_cancel_eventReturned when a client's attendance at a session could not be cancelled, for example because no matching attendance record exists for the booking. | |
0044 | replacements_limit_reachedReturned when the client has used the maximum number of make-up sessions. Not currently returned as its own error code. | |
0045 | invalid_replacement_creditReturned when the make-up credit used for a make-up session request is not valid, for example already used, expired or not applicable to the chosen session. | |
0047 | consent_requiredReturned when a client cancels a make-up session without confirming the required consent (for example that the make-up credit may be lost). Repeat the request with consent given. | |
0059 | event_not_foundReturned when the session referenced by the request does not exist or does not belong to the given class. | |
0061 | attendance_doesnt_existReturned when the attendance record does not exist. Not currently returned by the API. | |
0067 | already_canceledReturned when cancelling attendance at a session that has already been cancelled for this booking. | |
0244 | glue_set_invalid_vectorReturned when the matching rules for linking classes' sessions are malformed, switch off an always-on rule (location, date) or contain an unknown rule. | |
0245 | event_already_gluedReturned when saving a set of linked classes that includes a class already linked in another active set. The message carries the class id. The value ends the message. | |
0250 | replacement_admin_managedReturned when a client tries to book a make-up session for a class where make-ups are assigned only by the organiser. | |
0251 | additional_sessions_not_allowedReturned when a client tries to book an additional session but the programme does not allow additional sessions. | |
0252 | additional_sessions_limit_reachedReturned when the client has already booked the maximum number of additional sessions allowed. | |
0253 | additional_session_too_soonReturned when the chosen session starts too soon to be booked or moved as an additional session. Pick a later session. | |
0258 | additional_session_money_back_unavailableReturned when cancelling an additional session with a money-back option (e.g. refund or credit) that is not available for it. | |
0259 | additional_session_not_paidReturned when trying to move or cancel an additional session that has not been paid yet. | |
0260 | additional_session_cancellation_forfeitedReturned when trying to move or cancel an additional session after its cancellation deadline has passed. | |
0261 | additional_session_event_not_eligibleReturned when the chosen session cannot be used for an additional session. Pick another session from the offered list. | |
0353 | replacement_requires_paymentReturned when a client tries to book a make-up session while their booking is still unpaid. Pay the booking first. |
Programmes and classes
| Code | Name and meaning | English message |
|---|---|---|
0019 | course_doesnt_existReturned when the programme referenced by the request does not exist or is not available to your company. | |
0049 | schedule_doesnt_existReturned when the class referenced by the request does not exist or is not available to your company. | |
0265 | place_already_existReturned when creating a venue that already exists for the company. | |
0321 | course_not_availableReturned when an entry pass is linked to a programme that is inactive or deleted. | |
0322 | entry_pass_course_not_linkedReturned when you try to unlink an entry pass from a programme it is not sold on. | |
0328 | entry_pass_course_not_openReturned when an entry pass is linked to a programme that is not pay-as-you-go. | |
0335 | course_info_tab_enforcedReturned when a company tries to create, change, delete, reset or restore programme info content that its network enforces. | |
0345 | invalid_date_formatReturned when a date format setting for a programme's classes is not one of the allowed formats. | |
0368 | schedule_already_copied_to_billing_periodReturned when a class is copied into a billing period that already holds a copy of it. The value lists the id(s) of the existing copy. The value ends the message. |
Communication
| Code | Name and meaning | English message |
|---|---|---|
0026 | email_subject_missingReturned when sending an email message without a subject. | |
0027 | email_message_missingReturned when sending an email message without a body. | |
0028 | email_template_not_foundReturned when the requested email template does not exist. Not currently returned by the API. | |
0029 | no_recipientsReturned when sending a message or sharing a link with no recipients selected. | |
0042 | unknown_feedback_tokenReturned when a feedback link's token is missing, invalid or no longer valid. | |
0060 | invalid_amountReturned when sending a message to more than 10 recipients without a matching confirmation of the recipient count. Send the exact number of recipients as confirmation. | |
0212 | too_many_recipientsReturned when a shared link is sent to more than 10 recipients in one request. Split the recipients into smaller batches. | |
0214 | shared_link_daily_limitReturned when a shared link is sent to an address that is not an existing client and already received a shared link in the last 24 hours; the whole batch is refused. The message carries the address, one error per address. The value ends the message. | |
0239 | whatsapp_number_already_registeredReturned when a phone-number registration or verification step is requested for a WhatsApp number that is already connected to the WhatsApp Business app and needs no verification. | |
0266 | whatsapp_template_not_approvedReturned when sending a WhatsApp message with a template that has not been approved. | |
0355 | lecturer_bcc_requires_non_distinctReturned when a bulk message asks for a copy to the instructor while recipients are grouped per person. Turn off per-person grouping or drop the instructor copy. |
Integrations
| Code | Name and meaning | English message |
|---|---|---|
0030 | action_token_errorReturned when a token for an action or connected service is missing or invalid. Not currently returned as its own error code. | |
0069 | invalid_urlReturned when checking a booking form installation and the page address given is not a valid URL. | |
0070 | url_doesnt_existReturned when checking a booking form installation and the page address given could not be reached. | |
0071 | invalid_scriptReturned when checking a booking form installation and the Zooza script on the page is not the expected type. | |
0072 | too_many_scriptsReturned when checking a booking form installation and the page contains more than one Zooza script. | |
0073 | script_not_foundReturned when checking a booking form installation and no Zooza script was found on the page. | |
0150 | slack_oauth_state_invalidReturned (as an error on the redirect back to the app) when the Slack authorization response is missing or carries an invalid state. Start the Slack connection again. | |
0151 | slack_oauth_state_expiredReturned (as an error on the redirect back to the app) when the Slack authorization took too long and its state expired. Start the Slack connection again. | |
0152 | slack_oauth_exchange_failedReturned (as an error on the redirect back to the app) when connecting Slack fails after authorization, e.g. Slack rejects the authorization code. | |
0153 | slack_connection_not_foundReturned when the requested Slack connection does not exist for your company. | |
0154 | slack_connection_inactiveReturned when the Slack workspace installation is no longer active, so it cannot be connected or its channels listed. Reconnect Slack. | |
0155 | slack_needs_reauthReserved for when a Slack connection needs to be re-authorised. Not currently returned. | |
0156 | slack_workspace_owned_by_other_networkReturned when the Slack workspace is already connected to a different network than your company's. | |
0157 | slack_uninstall_owner_onlyReturned when a company that did not install the Slack workspace tries to disconnect it; only the installing company can. | |
0158 | slack_channel_not_foundReturned when the channels of the connected Slack workspace cannot be listed. | |
0159 | slack_invalid_targetReserved for when a Slack delivery target is invalid. Not currently returned. | |
0160 | slack_link_otp_invalidReserved for an invalid one-time code when linking a Slack user to a Zooza user. Not currently returned. | |
0161 | slack_link_otp_expiredReserved for an expired one-time code when linking a Slack user to a Zooza user. Not currently returned. | |
0162 | slack_link_otp_rate_limitedReserved for too many one-time code attempts when linking a Slack user to a Zooza user. Not currently returned. | |
0163 | slack_link_no_zooza_user_foundReserved for when no Zooza user matches a Slack user being linked. Not currently returned. | |
0164 | delivery_provider_not_foundReserved for an unknown notification delivery provider. Not currently returned. | |
0165 | delivery_subscription_not_foundReturned when the requested Slack notification subscription does not exist on that connection. | |
0166 | slack_install_not_foundReturned when the Slack workspace installation you try to connect to does not exist. | |
0200 | google_oauth_not_configuredReturned when you try to connect Google but the Google integration is not available on this server. | |
0201 | google_connection_not_foundReturned when your company has no Google connection for the requested action. Connect Google first. | |
0202 | google_service_not_foundReturned when the requested Google service is not connected for your company. | |
0203 | google_service_invalidReturned when you request a Google service that is not supported. The message ends with the service you sent. The value ends the message. | |
0204 | google_oauth_failedReturned when Google authorization fails during connection. The message ends with the reason reported by Google. The value ends the message. | |
0205 | google_business_profile_inactiveReturned when a Google Business Profile action is attempted but your company's Google Business Profile service is not active. | |
0206 | google_api_errorReturned when a request to Google fails, e.g. linking or submitting a venue, fetching locations or categories, or reading forms. The message ends with the operation that failed. The value ends the message. | |
0207 | google_location_not_foundReturned when no Google Business Profile account or location is available to submit a venue to. | |
0208 | missing_categoryReturned when a venue is submitted to Google Business Profile without a primary category. | |
0209 | missing_regionReturned when a venue is submitted to Google Business Profile but its address has no usable region. | |
0224 | google_forms_inactiveReturned when a Google Forms operation is requested but the Google Forms service is not connected for the company. Connect it first. | |
0225 | google_scope_not_grantedReturned when connecting a Google service and the user did not approve all the permissions that service needs. The message names the service; reconnect and approve all requested access. The value ends the message. | |
0226 | google_form_not_accessibleReturned when a Google Form cannot be opened with the connected Google account, e.g. it was deleted or belongs to another account. The message carries the form id. The value ends the message. | |
0227 | google_form_no_email_collectionReturned for a Google Form that does not collect respondents' email addresses, so it cannot be attached. Turn on email collection in Google Forms and attach it again. | |
0228 | google_form_invalid_send_triggerReturned when attaching a Google Form with a send moment that is not possible at that level, e.g. 'after registration' on a form attached to an existing booking. | |
0229 | google_form_answers_expiredReturned as the error key on a form response whose stored answers were deleted because the company's retention period passed. The form was completed but the answers are no longer available. | |
0230 | google_form_answers_purged_registrationReturned as the error key on a form response whose answers were deleted together with the booking. The form was completed but the answers are no longer available. | |
0231 | google_form_answers_purged_personReturned as the error key on a form response whose answers were deleted together with the client profile. The form was completed but the answers are no longer available. | |
0232 | google_form_answers_purged_formReturned as the error key on a form response whose answers were deleted because the form was removed from Zooza. The form was completed but the answers are no longer available. | |
0233 | google_form_answers_purgedReturned as the error key on a form response whose answers are no longer stored and the reason is not known. The form was completed but the answers are no longer available. | |
0267 | api_errorReturned when an external service the request depends on fails or is not configured, e.g. invoice document rendering or an SMS provider. The message names the failing service. The value ends the message. | |
0270 | oauth_failedReturned when an authorisation step with an external provider fails, e.g. revoking access to an invoicing service. The message names the operation. The value ends the message. | |
0271 | sync_failedReturned when synchronising data with an external system fails, e.g. invoicing accounts, invoice series or video domains. The message names what failed to sync. The value ends the message. | |
0272 | unsupported_providerReturned when the requested provider is not supported for the operation, e.g. an unknown email integration or invoice templates for a non-Zooza invoicing engine. The message names the provider where known. The value ends the message. | |
0273 | xero_auth_failedReturned when connecting Xero fails during authorisation. | |
0274 | domain_already_addedReturned when adding a video embedding domain that is already on the company's list. | |
0275 | domain_is_platform_managedReturned when adding a video embedding domain that Zooza already manages and always allows; it does not need to be added. | |
0276 | vimeo_domain_sync_failedReturned when the update of allowed domains on the company's videos could not be started. Try again. | |
0289 | meta_page_already_connectedReturned when activating a Facebook Page that is already connected to another company. The message carries the Page id. The value ends the message. | |
0290 | meta_graph_errorReturned when Meta (Facebook) rejects a request made on behalf of the connected account, for example while listing its pages. The message ends with the Meta resource that failed. The value ends the message. | |
0291 | meta_mapping_invalidReturned when a Meta lead form field mapping is malformed or points to a field that cannot be used. The message ends with the path of the invalid mapping entry. The value ends the message. | |
0292 | global_payments_keys_invalidReturned when the Global Payments App ID or App Key cannot be verified, either while connecting the account or when a payment is started. Check the credentials and connect again. | |
0293 | global_payments_connection_in_useReturned when you try to remove a Global Payments connection that is still the fallback for other connections or is linked to billing profiles. Reassign those first. | |
0341 | gp_webpay_keys_invalidReturned when the GP webpay merchant number or private key cannot be verified, either while connecting the account or when a payment is signed. Check the credentials and connect again. | |
0342 | gp_webpay_connection_in_useReturned when you try to remove a GP webpay connection that is still the fallback for other connections or is linked to billing profiles. Reassign those first. | |
0347 | integration_not_foundReturned when a payment needs an integration that is not connected, for example no GP webpay account is set up for the order. The message ends with the integration name. The value ends the message. | |
0362 | google_form_registration_out_of_reachReturned when a Google Form response is assigned to a booking the form is not attached to through its programme, class, session or booking. The message ends with the booking ID. The value ends the message. | |
0367 | meta_code_exchange_failedReturned when Meta does not accept the authorisation while connecting a Meta account. Connect Meta again. |
Files and documents
| Code | Name and meaning | English message |
|---|---|---|
0040 | upload_failedReturned when a file upload or generated file (such as an export) could not be stored, or when the upload request contained no file. | |
0179 | file_too_largeReturned when an uploaded file exceeds the maximum size allowed for that type of file. |
Other
| Code | Name and meaning | English message |
|---|---|---|
0050 | internal_errorReturned when an unexpected server-side problem stops the request, for example a failure to prepare storage for a document. Retry, and contact support if it persists. | |
0100 | todo_not_foundReturned when the requested to-do does not exist or does not belong to your company. | |
0102 | todo_assignee_not_in_companyReturned when a to-do is assigned to a user who has no role in your company. | |
0103 | todo_not_deletedReturned when you try to restore a to-do that is not deleted. | |
0192 | invalid_state_transitionReturned when a changelog entry is moved to a state that is not allowed from its current state, e.g. from draft straight to published. | |
0234 | placement_target_occupiedReturned when moving rows in a custom report into a section that already holds rows in other periods. The message carries the number of blocking periods and their dates. The value ends the message. | |
0240 | period_lockedReturned when changing or recalculating custom report data for a period that has been locked. The message carries who locked it and when. The value ends the message. | |
0268 | inserting_failedReturned when a record could not be created, e.g. an email signature or a VAT rate. The message names the record type. The value ends the message. | |
9999 | custom_errorGeneric error used where no specific code exists, for example when a payment cannot be requested because there is nothing to pay. The message carries the specific reason. The value ends the message. |
Payments
| Code | Name and meaning | English message |
|---|---|---|
0051 | product_doesnt_existReturned when an order refers to a product that does not exist or is not available. | |
0052 | parameter_not_foundReturned when a payment request cannot find the record it relies on. The message ends with what is missing, such as the order or the payment. The value ends the message. | |
0057 | unknown_payment_methodReturned when the requested payment method is not recognised or not available for this booking or order. | |
0066 | invalid_discount_codeReturned when the discount code does not exist, is no longer valid, or cannot be used for this class or booking. | |
0074 | payment_transfer_failedReturned when a payment cannot be moved from one booking or order to another, for example because only cash or bank transfer payments can be moved. The detail is returned alongside the message. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0075 | invalid_currencyReturned when the booking requests a currency the programme does not support. Some responses carry extra detail under key `0`, next to the message. The value comes under key 0. | |
0089 | online_card_provider_invalidReturned when the company's default programme settings name an online card payment provider that is not available for the company's region. The value ends the message. | |
0090 | direct_debit_provider_invalidReturned when the company's default programme settings name a direct debit provider that is not available for the company's region. The value ends the message. | |
0091 | online_transfer_provider_invalidReturned when the company's default programme settings set an online bank transfer provider; this payment method is no longer supported, so send null or omit it. The value ends the message. | |
0092 | gc_bank_data_reconnect_failedReturned when reconnecting the bank account feed on a billing profile fails. Try the reconnection again. | |
0093 | gc_bank_data_iban_not_foundReturned when you try to remove a bank account (IBAN) from a billing profile's bank feed and that IBAN is not connected to it. The value ends the message. | |
0094 | pso_offline_charge_disabledReturned when you manually send a scheduled payment to be charged automatically (stored card or direct debit), but automatic charging is not enabled for that booking's payment plan. | |
0095 | already_in_offline_queueReturned when you manually send a scheduled payment to be charged automatically, but it has already been queued for charging. | |
0096 | scheduled_payment_not_processedReturned when you manually send a scheduled payment to be charged automatically before it has been processed; only processed payments can be pushed. | |
0097 | missing_offline_charge_providerReturned when you manually send a scheduled payment to be charged automatically, but the booking has no stored card or direct debit provider to charge. | |
0098 | offline_charge_no_longer_eligibleReturned when you manually send a scheduled payment to be charged automatically, but the booking can no longer be charged that way, e.g. the stored card was removed or the direct debit mandate cancelled. | |
0167 | until_must_be_futureReturned when you set a payment grace period on a booking with an end date that is not in the future. | |
0168 | registration_paidReturned when you set a payment grace period on a booking that is already fully paid or has nothing to pay. | |
0191 | provider_not_connectedReturned when a payment provider is used (on a payment, or set on a programme) that your company has not connected. | |
0193 | segment_pricing_tier_exceeds_baseReturned when a payment plan's per-block pricing tier is set higher than the plan's base price. | |
0195 | discount_code_already_appliedReturned when a discount code is applied to a booking that already uses that code. | |
0196 | payment_routing_cycleReturned when a payment cannot be recorded because the bookings or orders that manage each other's payments form a loop. | |
0197 | payment_routing_depth_exceededReturned when a payment cannot be recorded because the chain of bookings or orders that manage each other's payments is too long. | |
0198 | payment_routing_cross_companyReturned when a payment would be recorded on a booking or order that manages it but belongs to another company. | |
0199 | cannot_modify_managed_registrationReturned when you change billing, the payment plan, the debt or the registration fee of a booking whose payments are managed by another booking or order. The message ends with the refused operation. The value ends the message. | |
0236 | payment_method_domain_registration_failedReturned when Stripe could not register a domain for wallet payments (e.g. Apple Pay, Google Pay). The message carries the domain; try again later. The value ends the message. | |
0237 | payment_method_domain_not_foundReturned when the requested payment-method domain does not exist in the company's Stripe account. The message carries the domain id. The value ends the message. | |
0238 | payment_method_domains_read_failedReturned when the list of registered payment-method domains could not be loaded from Stripe. Try again. | |
0254 | refund_requests_not_allowedReturned when a client submits a refund request but refund requests are not enabled for this booking or company. | |
0255 | refund_request_existsReturned when a client submits a refund request for a booking that already has one in progress. | |
0256 | refund_request_not_foundReturned when the referenced refund request does not exist or does not belong to the company. | |
0257 | refund_request_already_resolvedReturned when acting on a refund request that has already been resolved. | |
0277 | refund_gateway_declinedReturned when the payment provider declines or fails a refund. The message carries the provider's reason. The value ends the message. | |
0288 | provider_cannot_chargeReturned when a client tries to pay by card but the company's Stripe account cannot take charges yet (e.g. onboarding unfinished or the account disabled). | |
0294 | global_payments_declinedReturned when a Global Payments card payment is declined or does not complete. The client should check the card details or use another card. | |
0295 | payment_request_expiredReturned when a card payment is attempted on a payment request that has expired. Start a new payment instead of retrying the old one. | |
0296 | global_payments_sca_requiredReturned when a Global Payments card payment is submitted without a completed 3D Secure verification. The client must complete card verification with their bank and try again. | |
0317 | entry_pass_not_foundReturned when the requested entry pass does not exist in this company. | |
0318 | entrance_voucher_item_via_entry_passReturned when you try to add an entry pass item directly to a product. Entry pass packs are set up on the entry pass itself. | |
0319 | entry_pass_has_active_plansReturned when you try to archive an entry pass that a payment plan is still renewing. | |
0320 | entry_pass_variant_not_foundReturned when the requested entry pass pack does not exist on this entry pass. | |
0323 | entry_pass_template_already_linkedReturned when a payment plan is attached to an entry pass it is already attached to. | |
0324 | renewal_incompatible_variantReturned when a pack that is released before payment is used on an entry pass that renews through a payment plan. | |
0325 | renewal_plan_bills_its_own_cyclesReturned when you try to add a manual payment to a renewal payment plan. Renewal plans bill their own cycles. | |
0330 | payment_schedule_variant_not_in_orderReturned when the selected payment plan does not belong to any entry pass pack in the order. | |
0340 | registration_status_not_billableReturned when a payment plan is applied to a booking that is not in a registered status. | |
0343 | gp_webpay_declinedIntended for a declined GP webpay card payment; currently not returned on its own (its text is reused inside the refund-declined error). | |
0344 | refund_not_settled_yetReturned when a GP webpay payment is refunded before the bank has settled it. Try again once the payment has settled, usually the next day. | |
0348 | schedule_not_activeReturned when a payment plan is applied to a booking in a class that is not active. | |
0349 | schedule_endedReturned when a payment plan is applied to a booking in a class that has already ended. | |
0350 | schedule_lead_collectionReturned when a payment plan is applied to a booking in a lead collection class. | |
0351 | course_archivedReturned when a payment plan is applied to a booking in an archived programme. | |
0352 | payment_plan_not_activeReturned when you try to change a payment plan that has stopped or ended. Only its note can still be edited. | |
0354 | split_payment_template_existsReturned when creating a split payment template while the company already has one. Only one is allowed per company. |
Invoicing
| Code | Name and meaning | English message |
|---|---|---|
0082 | invoice_not_generatedReturned when refreshing an invoice's document before the invoice has been issued (it has no invoice number yet). | |
0088 | bank_statement_source_invalidReturned when a billing profile is saved with a bank statement source that is not one of the supported values. The value ends the message. | |
0215 | iban_already_used_by_profileReturned when saving a bank account whose IBAN is already used by another invoice profile. Use a different IBAN or edit the profile that already holds it. | |
0216 | billing_resolver_not_reconciledReturned when switching a company's invoicing over to invoice profiles is refused because existing billing data still has unresolved differences. Resolve the differences first, then retry. | |
0217 | cannot_delete_default_bank_accountReturned when trying to delete the default bank account. Set another account as default first. | |
0218 | cannot_delete_default_profileReturned when trying to delete the default invoice profile. | |
0269 | missing_resourceReturned when a programme references an invoice profile that cannot be found. The message names the missing resource. The value ends the message. | |
0304 | invoice_series_counter_lowerReturned when an invoice series counter would be set below its current value without confirmation. The message ends with the lowest allowed next number; confirm to lower it anyway. The value ends the message. | |
0305 | invoice_series_counter_conflictReturned when the invoice series counter was changed by someone else in the meantime. Reload the series and try again. | |
0306 | invoice_series_order_mismatchReturned when reordering invoice series with a list that does not match the current series. Reload the series and reorder them again. | |
0307 | invoice_series_ser_in_defaultReturned when the {SER} tag is used in the default invoice number format, where it is not allowed. Use it only in additional invoice series. | |
0308 | invoice_series_mode_unsupportedReturned when additional invoice number series are managed for a company whose invoicing system does not support them. | |
0309 | invoice_series_code_duplicateReturned when an invoice series code is already used by another series of the same billing profile, or one code is a prefix of another. The message ends with the conflicting code. The value ends the message. | |
0310 | invoice_series_template_invalidReturned when an invoice number template is not valid: it must start with {SER}, contain a counter, use only known tags, not place {VS} next to the counter, and stay within the length limit. | |
0311 | invoice_series_engine_series_unknownReturned when the chosen series cannot be found in the connected invoicing system. The message ends with the series name; refresh the list of series and choose again. The value ends the message. | |
0312 | invoice_series_code_lockedReturned when you try to change the code of an invoice series that already has issued invoices. The message ends with the locked code; create a new series instead. The value ends the message. | |
0363 | invoice_nothing_to_billReturned when an invoice is requested but no payment has been received since the last invoice, so there is nothing to bill. | |
0366 | invoice_creation_failedReturned when the invoicing system refuses to create an invoice that was issued immediately. The value carries the error reported by the invoicing system. The value ends the message. |
Direct debit
| Code | Name and meaning | English message |
|---|---|---|
0181 | mandate_id_format_invalid_bacsReturned when a direct debit mandate reference (or the mandate reference format being saved) does not meet the BACS rules, e.g. wrong length or characters. The value ends the message. | |
0182 | mandate_id_format_invalid_sepaReturned when a direct debit mandate reference (or the mandate reference format being saved) does not meet the SEPA rules, e.g. wrong length or characters. The value ends the message. | |
0183 | direct_debit_fields_invalidReturned when the payer's direct debit details (such as account holder or bank account) are missing or invalid. The value ends the message. | |
0184 | fastpay_token_invalidReturned when connecting FastPay with a token that FastPay rejects. Check the token and try again. | |
0185 | fastpay_connection_failedReserved for a failed FastPay connection. Not currently returned. | |
0186 | fastpay_not_connectedReturned when you submit a FastPay direct debit batch but the company has no FastPay connection. | |
0187 | fastpay_period_already_submittedReturned when a FastPay direct debit batch for that charge date has already been submitted; submitting it again would charge clients twice. The value ends the message. | |
0188 | fastpay_duplicate_referenceReturned when a FastPay direct debit batch cannot be built because two charges share the same direct debit reference. | |
0189 | fastpay_no_chargesReturned when there are no charges to collect for the requested FastPay batch and charge date. | |
0190 | fastpay_submission_failedReturned when a FastPay direct debit batch could not be submitted to FastPay. Nothing was charged, so you can retry. |
Something unclear or wrong on this page?Tell us