Ignisign

DOCS & KNOWLEDGE · FILES & DOCS

Signature requests, signers, and documents in the account they connected.

Connecting Ignisign in practice

Ignisign issues a separate skv2_ API key for each of its three environments — Development, Staging and Production — so promoting a working e-signature integration means re-keying rather than re-pointing. Its webhooks carry a verificationToken that you have to post back to Ignisign to validate if you are not using one of their SDKs, and your endpoint must answer 200 OK or the event counts as unreceived.

Scopes that draw scrutiny

skv2_ API key (per application, per environment) Sent as Authorization: Bearer and created in the console per environment. It is the whole grant — there is no narrower permission to request, so a production key can do everything the application can, including creating signature requests in the customer’s name.

Worth knowing

Without an SDK, webhook verification is an extra outbound call: you send appId, appEnv and verificationToken to Ignisign’s verification endpoint. The SDKs check appId and appEnv and verify the token for you.
Every webhook delivery must return 200 OK to confirm reception, so a handler that queues work and returns 202 will be treated as having failed.
Events are grouped into seven families — signer, signature request, signature session, signature proof, signature images, application and document request — so one endpoint has to fan out across all of them.
Because keys are environment-scoped, a staging key silently produces no production signature proofs rather than erroring in an obvious way.

Checked against API integration quick win (2026-09-29), Webhooks (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

ignisign_delete_v4_applications_by_appid_envs_by_appenv_signers_by_signerid_revokeWRITE

Revoke signer via DELETE /v4/applications/{appId}/envs/{appEnv}/signers/{signerId}/revoke

api

ignisign_delete_v4_documents_by_documentidWRITE

Remove document via DELETE /v4/documents/{documentId}

api

ignisign_delete_v4_documents_by_documentid_contentWRITE

Remove document content via DELETE /v4/documents/{documentId}/content

api

ignisign_delete_v4_webhooks_by_webhookidWRITE

Remove webhook endpoint via DELETE /v4/webhooks/{webhookId}

api

ignisign_get_v4_applications_by_appid_contextREAD

Get application context via GET /v4/applications/{appId}/context

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_bare_signatures_configurationREAD

Get bare signature configuration via GET /v4/applications/{appId}/envs/{appEnv}/bare-signatures-configuration

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signature_requestsREAD

Get signature requests by app ID and app env via GET /v4/applications/{appId}/envs/{appEnv}/signature-requests

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signer_profilesREAD

Get signer profiles via GET /v4/applications/{appId}/envs/{appEnv}/signer-profiles

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signer_profiles_by_signerprofileidREAD

Get signer profile via GET /v4/applications/{appId}/envs/{appEnv}/signer-profiles/{signerProfileId}

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signer_profiles_by_signerprofileid_inputs_neededREAD

Get signer inputs constraints from signer profile ID via GET /v4/applications/{appId}/envs/{appEnv}/signer-profiles/{signerProfileId}/inputs-needed

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signers_by_signeridREAD

Get signer summary via GET /v4/applications/{appId}/envs/{appEnv}/signers/{signerId}

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signers_by_signerid_detailsREAD

Get signer with details via GET /v4/applications/{appId}/envs/{appEnv}/signers/{signerId}/details

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_signers_paginateREAD

Get paginate application signers via GET /v4/applications/{appId}/envs/{appEnv}/signers-paginate

api

ignisign_get_v4_applications_by_appid_envs_by_appenv_webhooksREAD

Get webhook end points via GET /v4/applications/{appId}/envs/{appEnv}/webhooks

api

ignisign_get_v4_documents_by_documentidREAD

Get document by ID via GET /v4/documents/{documentId}

api

ignisign_get_v4_documents_by_documentid_contextREAD

Get document context via GET /v4/documents/{documentId}/context

api

ignisign_get_v4_documents_by_documentid_img_signaturesREAD

Get signature image via GET /v4/documents/{documentId}/img-signatures

api

ignisign_get_v4_envs_by_appenv_bare_signatures_proofsREAD

Get bare signature proofs via GET /v4/envs/{appEnv}/bare-signatures/proofs

api

ignisign_get_v4_signature_requests_by_signaturerequestid_contextREAD

Get signature request context via GET /v4/signature-requests/{signatureRequestId}/context

api

ignisign_get_v4_webhooks_by_webhookid_eventsREAD

Get webhook events via GET /v4/webhooks/{webhookId}/events

api

ignisign_get_v4_webhooks_by_webhookid_events_by_eventidREAD

Get webhook event via GET /v4/webhooks/{webhookId}/events/{eventId}

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_init_documentsWRITE

Init document via POST /v4/applications/{appId}/envs/{appEnv}/init-documents

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_log_capsulesWRITE

Log capsule create via POST /v4/applications/{appId}/envs/{appEnv}/log-capsules

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_m2m_by_m2mid_signWRITE

Sign M2M via POST /v4/applications/{appId}/envs/{appEnv}/m2m/{m2mId}/sign

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_signature_requestsWRITE

Init signature request via POST /v4/applications/{appId}/envs/{appEnv}/signature-requests

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_signersWRITE

Create signer via POST /v4/applications/{appId}/envs/{appEnv}/signers

api

ignisign_post_v4_applications_by_appid_envs_by_appenv_webhooksWRITE

Add webhook endpoint via POST /v4/applications/{appId}/envs/{appEnv}/webhooks

api

ignisign_post_v4_documents_by_documentid_data_json_contentWRITE

Provide document content data JSON via POST /v4/documents/{documentId}/data-json-content

api

ignisign_post_v4_documents_by_documentid_private_contentWRITE

Provide document content private content via POST /v4/documents/{documentId}/private-content

api

ignisign_post_v4_envs_by_appenv_oauth2_proofs_tokenWRITE

Get bare signature proof token via POST /v4/envs/{appEnv}/oauth2/proofs-token

api

ignisign_post_v4_signature_requests_by_signaturerequestid_closeWRITE

Close signature request via POST /v4/signature-requests/{signatureRequestId}/close

api

ignisign_post_v4_signature_requests_by_signaturerequestid_publishWRITE

Publish signature request via POST /v4/signature-requests/{signatureRequestId}/publish

api

ignisign_post_v4_signature_requests_one_call_signWRITE

Create signature request in one call via POST /v4/signature-requests/one-call-sign

api

ignisign_post_v4_tokens_webhook_verification_checking_consumptionWRITE

Check webhook event token via POST /v4/tokens/webhook-verification/checking-consumption. Checks whether a webhook verification token Ignisign delivered in a webhook payload has already been consumed. The `token` argument is that webhook token, not the connection's API key.

api

ignisign_post_v4_webhooks_by_webhookid_events_by_eventid_resendWRITE

Resend webhook event via POST /v4/webhooks/{webhookId}/events/{eventId}/resend

api

ignisign_put_v4_applications_by_appid_envs_by_appenv_signers_by_signeridWRITE

Update signer via PUT /v4/applications/{appId}/envs/{appEnv}/signers/{signerId}

api

ignisign_put_v4_applications_by_appid_envs_by_appenv_signers_by_signerid_regenerate_auth_secretWRITE

Regenerate signer auth secret via PUT /v4/applications/{appId}/envs/{appEnv}/signers/{signerId}/regenerate-auth-secret

api

ignisign_put_v4_documents_by_documentidWRITE

Update document via PUT /v4/documents/{documentId}