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.
- Get your App ID and secret key on the Convert settings page.
- 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.
- Use the JWT in your requests or extension config. For API calls, pass it in the
Authorization
header and the App ID inX-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.