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.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.
data_deletion.not_foundData deletion 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.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_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, or it's not readable.
document.not_compatibleThe Document is not compatible with the current action.
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.
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.
electronic_seal_image.limit_reachedThe limit of images 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.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.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.
follower.already_attached_to_signature_requestFollower already exists in the Signature Request
follower.already_attached_to_templateFollower already exists in the given Template.
otp.no_longer_usableThe given OTP (one-time password) cannot be used.
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.
otp.not_validToo many OTP requests done in the allowed time frame.
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.
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.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 doesn't 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 can't be reactivated.
signature_request.sender_not_validThere is an error in the Signature Request's sender configuration.
signature_request.sequential_signing_required_for_signature_levelSequential signing must be enabled for the given signature level.
signature_request.signable_document_requiredSignature Request does not have any signable 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_signer_placeholder_not_allowedThe Signature Request can't 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_signersThe number of signers in the Signature Request is greater than the authorized number.
signer.already_attached_to_signature_requestA Signer with the same information is already attached to the Signature Request.
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.disabled_notification_not_allowedThe feature "Disabled Email Notifications" is not available with your current plan.
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.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.signature_level_not_identical_for_allAll Signers should have the same signature level for this specific Signature Request level.
signer.status_not_compatibleThe current action is not compatible with the Signer's status.
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 Document Requests are not linked to any Signer. You need at least one Signer per Signer Document Request.
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.
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.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.sender_not_compatibleCannot create a Signature Request from the given Template because the sender type "user" is not compatible.
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.
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.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.