API Documentation

Importing Docs via API ¶

Using Productive’s API, you can efficiently import Docs (with text) into your account.

Note that it’s necessary to adapt the content, such as bullets, numbers, callouts, and headers, to fit our JSON structure when utilising JSON objects. For detailed documentation on the document format, refer to the Productive API Documentation guide covering the Document Format.

Tip: To avoid potential sync issues, a Doc shouldn’t be updated via API while someone has the Doc open in the interface.

Creating New Docs ¶

To create new docs, you’ll interact with the pages endpoint.

​ POST Endpoint:

POST https://api.productive.io/api/v2/pages

You must send JSON inside the body under attributes. When using Postman, JSON should be sent as a string.

You can utilize JSON.stringify() for this purpose.

Note: If you do not see changes on your Doc after updating it, this could be because the docs-realtime system cached the previous version. It may take up to one hour for the new changes to appear, as the docs-realtime system refreshes its cache periodically.