GraphQL Guide

The GraphQL API gives you insight into your account and the objects it owns, allow you to create, update, start, and submit data to both Workflows Etch e-sign packets.

First check out the API getting started article to learn how to get an API key and use it to authenticate to the API. Additionally, brushing up on our terminology will be helpful in understanding the queries below.

GraphQL Reference

This guide will help you get started using common queries and mutations. For a complete list of queries, mutations, and types see the GraphQL reference.

Postman Collection

To get you and running with the GraphQL API without writing code, see the examples in our GraphQL Postman Collection.

API clients

We have created Node.js, Python, and C#/.NET API clients to help our users interact with our API more easily. They help to simplify:

  • Authentication
  • Common GraphQL calls
  • Raw REST and GraphQL calls
  • GraphQL calls involving binary file uploads

Your first query

All queries are POSTs to a single URL: https://graphql.useanvil.com.

A good place to start is with the currentUser query. This query will return your API user with all the main objects (etchPackets: Etch e-sign packets, casts: PDF templates, welds: Workflows, and forges: webforms) on your account.

POST https://graphql.useanvil.com
{
currentUser {
eid
organizations {
eid
name
slug
casts {
eid
name
config
}
etchPackets {
eid
name
isTest
status
detailsURL
}
welds {
eid
name
config
forges {
eid
name
config
}
}
}
}
}

Workflow queries & mutations

See the workflows API guide for comprehensive docs.

E-Signature queries & mutations

See the e-signature API guide for comprehensive docs.

GraphQL schema SDL

You can download the entire Anvil GraphQL schema by making a GET request to https://app.useanvil.com/graphql/sdl. Note that you must be logged in to Anvil in order to access our GraphQL schema. You can be logged in as a normal user or you can authenticate with your API key.

back to articles
Giant Bottom Asset
Desktop Bottom Asset
Tablet Bottom Asset
Mobile Bottom Asset
Giant Top Asset
Desktop Top Asset
Tablet Top Asset
Mobile Top Asset