Get Started with GraphQL

Legalesign offers two APIs for e-signature integration:

• REST API - Quick start, traditional format
• GraphQL API - Full power, more flexible

This guide focuses on GraphQL. You'll need JSON knowledge and basic web request experience.

Why Choose GraphQL?

GraphQL gives you complete access to Legalesign's features:

• Request only the data you need
• Single endpoint for everything
• Same power as the web app

TypeScript/JavaScript Developers

Consider the TS/JS SDK for common use cases, but learning GraphQL gives you full platform access. Compare SDK vs GraphQL.

Try GraphQL Now

Start with the GraphQL Explorer (requires active account).

The Explorer lets you:

• Test queries and mutations
• Browse the complete schema
• Debug before coding

info

If you're logged into Legalesign, authentication is automatic.

Your First Query

Paste this query into the Explorer:

query myInfo {
    user {
        id        
        firstName
        lastName
        email
    }
}

Use the schema icon (top-left) to explore available fields. Paste your query and click play.

info

Start here! The Explorer confirms your account works and teaches GraphQL syntax before you write code.

Expected Result

{
  "data": {
    "user": {
      "id": "dXNyNjBkNWNkODktMDg3NS00ZXC67mItZjI3ODA5NjgwMDdl",
      "firstName": "Tester",
      "lastName": "Api",
      "email": "api.tester@legalesign.com"
    }
  }
}

This gets your user info. GraphQL handles complex nested queries and mutations (data changes).

tip

Find ready-made queries by inspecting network requests in the Legalesign web app console.

Next Steps

1. Explore the schema in the GraphQL Explorer
2. Test queries for your use case
3. Integrate into your application

GraphQL gives you the same power as the Legalesign web app—if you can do it there, you can do it with the API.