Paper documentation
Personal API

Developer mode

The switch that unlocks tokens, file uploads, calendar changes and remote automations.

The app stays the same with developer mode on. It only unlocks access tokens. Without it, no token works, not even existing ones.

Turn it on

Open Settings → Developer.

Read the API terms of use, check the acceptance box and tap Turn on developer mode.

Copy your account ID, shown at the top. It goes in the X-Paper-Account header and confirms the token is yours. See Authentication.

Allow Google for the API

Regular tokens read and write in the real vaults through your Google Drive. For that, the server needs to keep your Google connection.

  • Google Drive for the API: connect Google in Sync and tap Allow this device's connection for the API.
  • Calendar for the API: connect Google Calendar in Integrations and tap Allow the "Paper" calendar for the API.

The server only acts on your Drive and calendar when one of your tokens is used. Secure tokens need none of this.

What the mode unlocks

FeatureWithout the modeWith the mode
Access tokensDon't workUp to 20 active
Reading and writing pages from a programNoWhere the token allows
Uploading files through the APINoUp to 30 per day, 10 MB each
Creating and deleting events in the "Paper" calendarNoIf the token allows
Remote automations (scripts, servers, agents)NoYes

When the terms change

If the API terms get a new version, your tokens pause until you accept it in Settings → Developer. The API answers 403 with a message saying so.

Turn it off

Turn off developer mode revokes all tokens right away, deletes the copies for AI and deletes the Google connection stored on the server. Your notes don't change.

Banned account

If the account is banned for violating the terms, all tokens are revoked, published links are taken down and the Google connection stored on the server is deleted. See Bans and appeals.

On this page