Getting Started

How to set up a basic signing flow with the Idura Signatures API

Prerequisite: create an Idura Signatures application to get a set of client credentials.
Create a signature order with one or more PDFs for signing.
Add one or more signatories.
Redirect each signatory to their unique signing link and wait for them to sign.
Close the signature order to retrieve the signed PDFs.

Step 1: Set up the Dashboard

Before writing any code, set up your environment in the Idura Dashboard to get your API credentials.

Set up the Dashboard: Create a tenant, register a domain and an application, and get your client ID and client secret.

Step 2: Create test users

You cannot use your real, personal eID to test signings in a development environment. Instead, national eID schemes require dummy accounts for testing.

Create test users: Learn how to generate test identities for the eIDs you’ll be working with.

Step 3: Build your integration

The Idura Signatures API is built with GraphQL. You can call it from any language or stack, and build signing workflows tailored to your needs.

A primer on GraphQL: New to GraphQL? Start here to learn how it works.
Interactive tour: Step through the queries and mutations that make up a full signing flow.
GraphQL examples: See queries and mutations for common tasks.

Prefer an SDK?

We offer client libraries for these platforms:

Step 4: Move to production

Once your integration is working with test users, it’s time to go live.

Get ready for production: Review the checklist for purchasing a subscription, applying for the eIDs you need, and going live.

We recommend starting the application process as early as possible. Approval and certificate issuance can take several business days depending on the eID provider.

Learn more