Errors List

Errors we send back on any Client error (4xx HTTP requests).

Error codeDescription
resource.not_foundThis error corresponds to the 404 HTTP error for any resource.
about:blankThis error depends on the context. Please read the description when this error occurs for more information.
parameters_not_validYou have some invalid params in your payload.
approver.already_attached_to_signature_requestAn Approver with the same information is already attached to the Signature Request.
approver.multiple_identities_duplicate_memberThe same identity appears more than once in the Approver roster.
approver.reordering_not_allowedReordering Approvers is not allowed in this context.
approver.status_not_compatibleThe Approver must be in the right status to perform this action.
audit_trail.not_ready_for_downloadThe Audit Trail is not ready to be downloaded yet.
configuration.archive_y_identifier_requiredUnable to archive the file because the archive Y identifier is missing for the organization.
configuration.not_enabledA given feature is required to perform this action.
consumption.date_out_of_rangeThe given date range is out of the valid range.
contact.workspace_not_identicalA contact restricted to a single workspace cannot be used as a signer or Approver for a Signature Request from another workspace.
custom_experience.scope_not_compatibleThe Custom Experience's Workspace is not compatible with the resource's Workspace.
data_deletion.conflict_stateData deletion cannot be performed.
data_deletion.not_foundData deletion cannot be found.
orchestration_transition.not_foundThe Data Deletion Transition cannot be found.
data_deletion.request_already_existsData deletion request already exists for organization.
date.out_of_rangeThe given date range is invalid: the start date is greater than the end date.
document_visibility.approver_has_no_visible_documentThe Approver has no visible Document in this Signature Request.
document_visibility.attachment_document_has_no_visible_recipientThe attachment Document has no visible recipient in this Signature Request.
document_visibility.signable_document_has_no_visible_signerThe signable Document has no visible Signer in this Signature Request.
document_visibility.signer_has_no_visible_documentThe Signer has no visible signable Document in this Signature Request.
document_visibility.signer_with_field_cannot_be_restrictedA Signer with a Field on a Document cannot be excluded from its visibility.
document_visibility.visibility_entries_must_cover_all_combinations_of_recipients_and_documentsVisibility entries must cover all documents and all recipients.
document.already_attached_to_a_signature_requestThe Document is already attached to a Signature Request. To attach a Document to another Signature Request you need to re-upload it first.
document.already_attached_to_an_electronic_sealThe Document is already used for another electronic seal.
document.analyze_errorAn error has been detected on the given Document.
document.delete_failedThe given Document could not be permanently deleted.
document.has_failedFailed to check if a given Document exists
document.lockedDocument is locked, you need to provide its password before adding Signers.
document.not_compatibleThe Document is not compatible with the current action.
document.not_replaceableUnable to replace the Document.
document.not_unlockableCannot upload the Document because it fails to be unlocked.
document.not_usableThe Document is not valid. For example its extension is invalid, is not readable.
document.not_valid_attachmentDocument cannot be marked as attachment.
document.number_of_pages_limit_exceededThe file has too much pages than allowed.
document.size_too_largeSize of Document is too large to be performed.
document.storage_failedAn error occurred while processing the Document.
document_analysis.type_not_extractableThe given document analysis type does not support extraction.
electronic_seal_image.limit_reachedThe limit of images for the electronic seal has been reached.
electronic_seal.not_valid_secretThe secret is invalid.
electronic_seal.signature_level_not_compatibleThe Electronic Seal signature level is not compatible with the current action.
electronic_seal.signature_level_not_enabledThe Organization is unable to create electronic seal with "electronic_signature" level.
electronic_seal.status_not_compatibleCannot add an unsealed Electronic Seal Document to the Signature Request.
electronic_seal.too_many_fieldsThe limit of Fields for the electronic seal has been reached.
field.answer_requiredUnable to sign the Document because a field requires an answer.
field.cannot_update_dimensionsUnable to update dimensions of a given Document.
field.checkbox_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.dimensions_not_validThe dimensions for the Field are invalid.
field.initials_area_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.mention_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.signature_date_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.signer_name_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.signer_email_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.non_uniqueA Field contains value options with duplicate names but must be unique.
field.only_one_of_type_signature_per_document_and_signerWith the current signature level, only one signature Field per Document and per signer is allowed.
field.out_of_document_boundsUnable to add a Field on a given Document because it is too small.
field.radio_button_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.readonlyRead-only Field cannot be updated.
field.read_only_text_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.signer_not_allowedThe provided Field cannot be attached to a Signer.
field.text_field_configuration_not_enabledThe given configuration is not enabled for this organization.
field.type_not_allowed_for_documentUnauthorized to add initials area Field because the Document is already signed or Field is not allowed for this nature of Document.
field.type_not_compatibleUnable to provide an answer to a Field which does not wait for an answer.
field.value_exceeds_max_lengthGiven length cannot be greater than the allowed max length.
follower.already_attached_to_signature_requestFollower already exists in the Signature Request
follower.already_attached_to_templateFollower already exists in the given Template.
label.limit_reachedThe limit of Labels has been reached, you cannot create more.
label.name_already_existsA Label with a given name already exists in the organization. Label name must be unique.
otp.no_longer_usableThe given OTP (one-time password) cannot be used.
otp.not_validThe OTP is not valid.
otp.phone_number_not_compatibleThe phone number is not compatible with the current OTP mechanism.
otp.too_many_requestsToo many OTP requests done in the allowed time frame.
permanent_delete.unexpected_remove_countExpected to delete a given number of rows but another number were really deleted.
radio_group.radio_not_foundA Radio Group does not have a Radio Button with the given name.
request.ip_not_validThe given ip address is not correct.
resource.not_availableResource not available, please retry later.
sending_schedule.status_not_compatibleSending schedule "%s" cannot be updated because its status is "%s" while it must be "%s".
signature_request.bulk_sentCannot process the Signature Request that was created through a bulk send.
signature_request.decline_to_sign_not_allowedOrganization does not authorize activation of "decline to sign" on Signature Request.
signature_request.delivery_mode_not_compatibleThe current action is not compatible with the current delivery mode.
signature_request.expiration_date_out_of_rangeThe given Signature Request's expiration date is not within the allowed range.
signature_request.expiredSignature Request cannot be sent because its expiration date has passed.
signature_request.label_already_existsLabel already exists for the Signature Request.
signature_request.metadata_already_existsThe Signature Request already has metadata. You can still update them.
signature_request.migratedThe Signature Request is migrated from an older version, it cannot be permanently deleted.
signature_request.no_documentThe Signature Request does not have any Document, therefore the actual action cannot be performed.
signature_request.not_activatableThe Signature Request cannot be activated in its current state.
signature_request.not_reactivableThe Signature Request cannot be reactivated.
signature_request.sender_not_validThere is an error in the Signature Request's sender configuration.
signature_request.sequential_signing_required_for_signature_levelParameter "ordered_signers" must be enabled on Signature Request for the "qualified_electronic_signature" signature level
signature_request.signable_document_requiredSignature Request does not have any signable Document, thus it cannot be sent.
signature_request.placeholder_document_presentSignature Request has placeholder document, thus it cannot be sent.
signature_request.signature_image_type_not_allowedSignature Request does not allow to sign with a signature image.
signature_request.signer_requiredSignature Request does not have any recipient, thus it cannot be sent.
signature_request.source_not_validThe Signature Request has been created from the Yousign application, thus it cannot be activated from the API.
signature_request.status_not_compatibleThe actual action is not compatible with the Signature Request's status.
signature_request.status_not_compatible_with_requestSignature Request status is not draft, thus you are unable to add an Approver.
signature_request.template_with_recipient_group_not_allowedThe Signature Request cannot be initiated from a Template having a recipient group.
signature_request.template_with_signer_placeholder_not_allowedThe Signature Request cannot be initiated from a Template having a Signer placeholder.
signature_request.too_many_approversUnable to add an Approver because you reached the maximum number allowed on this Signature Request.
signature_request.too_many_documentsThe number of Documents in the Signature Request is greater than the authorized number.
signature_request.too_many_fieldsThe Fields limit for Signature Request has been exceeded.
signature_request.too_many_followersToo many followers on the Signature Request.
signature_request.too_many_labelsThe quota of Labels on a Signature Request has been reached.
signature_request.too_many_signersThe number of signers in the Signature Request is greater than the authorized number.
signature_request.embedded_preparation_link_not_supportedThe Signature Request is not supported by the Embedded Preparation.
signer.already_attached_to_signature_requestA Signer with the same information is already attached to the Signature Request.
signer.already_existA Signer with same information already exists.
signer.authentication_mode_not_allowed_for_signature_levelThe authentication mode and the signature level for the signer are not compatible.
signer.authentication_mode_not_compatibleThe Signer authentication mode is not compatible with the current action.
signer.authentication_mode_not_enabled_for_signature_levelThe signature level with the given authentication mode is not enabled for your organization.
signer.cannot_be_unblockedThe Signer cannot be unblocked because the Signature Request "%s" is not ongoing.
signer.consent_date_not_validThe Signer's consent date must be between the date the Signature Request is sent and now.
signer_consent_request.limit_reachedUnable to add a Signer Consent Request because you reached the maximum allowed quota on this Signature Request.
signer_consent_request.signer_requiredSigner Consent Requests are not linked to any Signer. You need at least one Signer per Signer Document Request.
signer.delivery_mode_not_compatibleThe Signer must have delivery mode set to none to verify its identity.
signer.disabled_notification_not_allowedThe feature "Disabled Email Notifications" is not available with your current plan.
signer_document_request.limit_reachedUnable to add a Signer Document Request because you reached the maximum allowed quota on this Signature Request.
signer_document_request.signer_requiredSigner Document Requests are not linked to any Signer. You need at least one Signer per Signer Document Request.
signer.field_requiredThe Signer does not have any Field. You need at least one Field per Signer.
signer.identification_status_not_compatibleUnable to update a Signer with the current identification status.
signer.identification_delegation_not_compatibleDelegation, upload and verify is only available for Signers that do not delegate identification.
signer.verified_identity_not_compatibleThis action is only available for Signers that do not used verified identity.
signer.identification_process_conflictOnly one feature "pre_identity_verification", "advanced_electronic_signature_via_verify", "identification_attestation_id" can be used for e-signature identification.
signer.multiple_identities_duplicate_memberThe same identity appears more than once in the Signer roster.
signer.otp_not_expectedThe Signer's authentication mode is "%s" thus OTP is not expected.
signer.otp_requiredThe Signer is associated to an authentication mode requiring an OTP (one-time password).
signer.phone_number_requiredSigner's phone number is required in this case.
signer.reordering_not_allowedReordering Signers is not allowed in this context.
signer.signature_level_not_availableThe given signature level for Signer is not available in the current context.
signer.signature_level_not_compatibleThe Signer signature level is not compatible with the current action.
signer.signature_level_not_enabledThe signature level is not enabled for your organization.
signer.status_not_compatibleThe current action is not compatible with the Signer's status.
signer.verified_identity_signer_modifiedIt's not possible to modify Signer's information when an identification verified is affected to the Signer.
smart_anchor.parsing_failedUnable to parse smart anchors for the given Document.
subscription.limit_reachedYou have reached the limit of your subscription quota.
subscription.plan_type_not_compatibleThe data deletion cannot be requested when the subscription is not compatible.
subscription.status_not_compatibleThe current status of the subscription is in conflict with the action to fulfil.
template.all_placeholders_not_replacedAll placeholder Signers defined in a given Template must be replaced.
template.cannot_convert_with_actor_substituteThe Template cannot be converted.
template.create_from_signature_request_require_documentsThe Signature Request requires the conversion of at least one Document into a Template.
template.limit_reachedUnable to create a Signature Request because the maximum number of Templates has been exceeded.
template.status_not_compatibleThe given Template is not in the right status to perform your action.
template.too_many_fieldsThe Fields limit for Template has been exceeded.
template.too_many_followersToo many followers on the template.
template.workspace_not_identicalGiven Workspace does not match the one set for the Template.
verified_identity.workspace_not_identicalThe given Identity Verification does not belong to your workspace.
verified_identity.state_not_validThe given Identity Verification state is not valid.
verified_identity.id_document_not_compatibleThe given Identity Verification can't be used as a reusable decision because the identity document used type is not accepted for an advanced e-signature
verified_identity.already_usedThe given Identity Verification was already used on a Signer for an advanced signature.
verified_identity_proof.identification_not_validVerified identity proof is only available for succeeded identification performed with Video Identity verification for a Qualified Electronic Signature.
verified_identity_proof.not_availableVerified identity proof is not available for this signer. It may not be generated yet or is no longer available.
verified_identity_proof.recover_failedAn error occurred while recovering the verified identity proof.
user.already_attached_to_workspaceUser already attached to Workspace.
user.already_existsA User with this email address already exists.
user.email_not_allowed_for_ssoEmail in not allowed in the context of SSO.
user.invitation_already_existsAn Invitation with the given email already exists.
user.invitation_not_acceptedThe User status is "invited", so it cannot be updated.
user.not_activeThe User is currently suspended, so no changes can be made.
user.ownerThe User is the current Organization's owner, so no changes can be made.
user.scim_activatedAction denied because SCIM provisioning is active. Please use your Identity Provider to manage users and invitations, or disable SCIM in your Identity Provider.
user.state_not_validThe User has no first name and/or last name.
user.status_not_compatibleThe User status is not "invited".
user.workspace_requiredUser must be in at least one Workspace.
webhook_subscription.workspace_requiredWebhook Subscription is not associated with any Workspace but at least one Workspace is required.
workspace.already_as_defaultThe given Workspace is already the default one of the organization.
workspace.already_deletedThe given workspace has already been deleted.
workspace.deletion_not_allowedUnable to delete a given Workspace for a specific reason.
workflow_session.action_already_resolvedThe given Workflow Session Action has already been resolved.
workflow_session.invalid_resource_statusThe given resource does not have a compatible status for the current action.
workflow_session.limit_reachedThe Workflow Session has reached the maximum number of allowed Actions.
workflow_session.resource_not_compatibleThe Workflow Session has no Action Group with a type compatible with the given resource.
workflow_resource.applicant_not_compatibleThe resource is compatible with the given Applicant.
workflow_applicant.data_lockedSome data of the Applicant cannot be modified because they are locked.
workflow.applicant_dataUnable to generate Magic Link: some applicant data is missing.
workflow_applicant.parent_not_legal_personThe parent Applicant must be a legal person.
workflow_applicant.parent_not_in_same_workflow_sessionThe parent Applicant must belong to the same Workflow Session.
workflow_applicant.hierarchy_too_deepThe parent Applicant is already a child and cannot itself have children.
workflow_applicant.child_must_not_have_deliveryA child Applicant must have its delivery mode set to "none".
workflow_applicant.children_not_allowedChild Applicants are not enabled for this organization.
workflow_applicant.parent_immutable_after_linkThe parent Applicant cannot be changed once a Magic Link has been generated for the Workflow Session.