Integrations
How to connect Unecast with external tools, services, and automate workflows.
Overview
Unecast supports seamless integrations with popular tools to automate your workflows. Connect your GitHub repositories for automatic documentation syncing, set up webhooks for real-time events, embed content in third-party apps, and handle exports or imports effortlessly.
GitHub Sync
Automatically sync your repo changes to Unecast docs.
Webhooks
Receive event notifications in your apps.
Third-party Embeds
Embed Unecast content anywhere.
Export/Import
Move data in and out easily.
All integrations require a valid API key from your Unecast dashboard at https://dashboard.example.com.
GitHub Sync
Sync your GitHub repository with Unecast to keep documentation up-to-date automatically.
Create a Personal Access Token
In GitHub, go to Settings > Developer settings > Personal access tokens. Generate a new token with repo scope.
Connect in Unecast Dashboard
Navigate to Integrations > GitHub in your dashboard. Paste the token and select your repository.
Configure Sync Rules
Set paths to watch, like docs/*.mdx, and enable auto-publish on push.
Once set up, pushes to your repo trigger rebuilds in under {<1min}.
Webhook Setup
Webhooks let you react to Unecast events like document updates or user actions. Configure them via the dashboard or API.
Your endpoint URL, e.g., https://your-webhook-url.com/webhook.
HMAC SHA-256 signature for verification using your secret.
const express = require('express');
const crypto = require('crypto');
const app = express();
app.post('/webhook', express.raw({type: 'application/json'}), (req, res) => {
const signature = `Unecast-Signature: ${crypto.createHmac('sha256', 'YOUR_SECRET').update(req.body).digest('hex')}`;
console.log('Event:', JSON.parse(req.body.toString()));
res.status(200).send('OK');
});
app.listen(3000);
import hmac
import hashlib
from flask import Flask, request
app = Flask(__name__)
SECRET = b'YOUR_SECRET'
@app.route('/webhook', methods=['POST'])
def webhook():
signature = hmac.new(SECRET, request.data, hashlib.sha256).hexdigest()
print('Event:', request.json)
return 'OK', 200
if __name__ == '__main__':
app.run(port=3000)
Always verify signatures to prevent replay attacks. Test webhooks using the dashboard's "Send Test" button.
Third-party Embeds
Embed Unecast pages or components in tools like Slack, Notion, or your website.
Use this snippet to post dynamic embeds:
<iframe src="https://docs.example.com/embed/page-id" width="100%" height="400" frameborder="0"></iframe>
Paste into Slack's custom app or message composer.
Add responsive embeds:
<div style="position: relative; padding-bottom: 56.25%;">
<iframe src="https://docs.example.com/embed/page-id" style="position: absolute; width: 100%; height: 100%;" frameborder="0"></iframe>
</div>
Export and Import Options
Export your documentation as Markdown, PDF, or JSON. Import from GitHub, Google Docs, or ZIP files.
| Format | Export | Import | Use Case |
|---|---|---|---|
| Markdown | Yes | Yes | Git repos, static sites |
| Yes | No | Printing, sharing | |
| JSON | Yes | Yes | API migrations |
GitHub Sync
Full two-way sync
Slack Embeds
Rich previews
Notion Import
Direct from pages
Zapier
No-code automations