Authenticate your conversion service

Tiptap Conversion lets you import and export Tiptap JSON to and from DOCX, ODT, and Markdown. You can integrate import/export directly in your Tiptap editor with dedicated extensions, or use the Conversion REST API on your server.

Set up authorization

Most conversion operations require authentication. Generate a JWT (JSON Web Token) using the secret key from your Tiptap Cloud account. Include this JWT in requests or extension configs.

Export DOCX Extension

The extension-export-docx package does not require authentication! Feel free to skip these steps if you only need that extension.

  1. Get your App ID and secret key on the Convert settings page.
  2. Generate a JWT for testing using any JWT tool (e.g., JWT Builder). For production, always create JWTs server-side to keep your secret safe.
  3. Use the JWT in your requests or extension config. For API calls, pass it in the Authorization header and the App ID in X-App-Id.

Explore file-type integrations

Depending on which format you want to work with, each file type has its own guide to installing and configuring the relevant import and export extensions:

These guides explain exactly how to integrate the respective extension and REST API endpoints into your application and configure any necessary options.