Skip to main content

Auto-signature Request

This endpoint requests the auto-signature enablement for an approved issuer. In the same call, QI Tech generates the adoption agreement and opens the signature envelope, so the response already returns with the enablement ready to be signed.

See the auto-signature flow for the complete sequence.

Approved issuer

The request is only accepted when the issuer registration is in the approved status and the client is enabled for auto-signature. There is no automatic creation — nothing happens until this endpoint is called.

Auto-signature Request (POST)​

Request​

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/auto_signature
METHOD
POST

Path Params​

FieldTypeDescriptionCharacters
ISSUER-KEYstringUnique issuer key (UUID v4).36

Request Body​

This endpoint takes no body. The signer group and the adoption agreement template are resolved by QI Tech from the issuer registration and the client configuration.

Response​

STATUS
201
Response Body
{
  "issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
  "status": "pending_signature",
  "signed_at": null,
  "enabled_at": null,
  "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
  "term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
  "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce",
  "created_at": "2026-02-10T09:15:44",
  "event_list": [
    {
      "event_type": "auto_signature_creation",
      "status": "pending_term_generation",
      "event_data": {
        "tenant_key": "5e3045af-8be8-4cbd-9aab-9e15c4e92154"
      },
      "created_at": "2026-02-10T09:15:44"
    },
    {
      "event_type": "adhesion_term_generation",
      "status": "pending_term_generation",
      "event_data": {
        "term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
        "template_key": "b71f1a2c-9e44-4c1d-8f3a-6d2c0b5e7a19"
      },
      "created_at": "2026-02-10T09:15:46"
    },
    {
      "event_type": "envelope_creation",
      "status": "pending_signature",
      "event_data": {
        "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce"
      },
      "created_at": "2026-02-10T09:15:47"
    }
  ]
}

The response is the same object as the auto-signature query, usually already in pending_signature, with term_document_key and envelope_key filled in. Next, query the signature links to get each signer's link.

Errors​

HTTPCodeWhen it occurs
400ISS0000032 (IssuerNotApproved)The issuer is not in the approved status.
400ISS0000033 (AutoSignatureNotEnabledForTenant)The client is not enabled for auto-signature.
403ISS000011 (TenantForbidden)The client does not have full access to the registration of the given issuer.
404ISS000009 (IssuerNotFound)There is no issuer for the given key.
404ISS0000026 (TenantConfigurationNotFound)The client has no auto-signature configuration registered.
409ISS0000029 (AutoSignatureAlreadyExists)The issuer already has an active auto-signature in pending_signature or enabled. Cancel the current one before requesting another.