Team Wiki

Superhuman Docs API

In this Getting Started Guide, we'll introduce you to the Superhuman Docs API and share examples of how to do more with your docs programatically.

Oleg Vaskevich

Access your docs programmatically.

It's easy to create and edit Superhuman Docs in your browser, but sometimes you need programmatic access to automate parts of your workflow. The Superhuman Docs API enables you to read and write data to your Superhuman Docs document using code.

In this Getting Started Guide, we'll introduce you to the

API⁠

and share examples of how to do more with your documents using the API. This guide assumes that you are familiar with writing code.

If you want to build an integration without writing code, check out the Zapier links in the quick links section below!

Zapier⁠

is an app that allows you to build workflows connecting two or more apps without code.

What are examples of things you can do with the API?

Sync data between a table in one Superhuman Docs document and a table in another Superhuman Docs doc.

e.g. Syncing data between a company goal tracker to your team's roadmap.

Set up automated reminders.

e.g. Send your teammates emails or Slack messages when their tasks are overdue.

Complement a

Zap⁠

you are setting up.

e.g. Do a bulk import of data in another app to complement a Zap you are setting up.

Set up a deep integration between another app and Superhuman Docs.

e.g., Build out a database view of your calendar in Superhuman Docs and use it to track notes, action items, and more.

If you have feedback on the API or you build something that can benefit the entire Superhuman Docs community,

let us know⁠

Let's start with some examples

For these examples, we'll be using

Google Apps Script⁠

(

v8 runtime⁠

), which lets you write code in a JavaScript-like syntax and use built-in libraries for many Google products, as well as the Coda API library. What's more, you can set up a schedule to run your scripts periodically, and best of all, it's freeーperfect for getting acquainted with the Superhuman Docs API.

If you haven't used Apps Script before, don't worry! The syntax is straightforward, and you should be able to pick it up easily if you've used JavaScript or another procedural language like Python or Java. Of course, you can always use other mechanisms to host your scripts and access our API if you prefer not to use Apps Script.

We recommend tackling these in order, but feel free to skip ahead once you've gotten through the first one.