Public API
Automate everything that repeats.
REST API and webhooks for every mekyn endpoint — content, SEO reports, leads, builds, domain actions. Build your own tools, sync to Notion or Slack, or use mekyn as the backend of your stack.
Six building blocks for automation
-
REST API
Fully documented REST endpoints for CRUD on Sites, Pages, Blocks, Domains, Leads — JSON in, JSON out.
-
Webhooks
Events: site.published, lead.received, seo.report.ready, backlink.detected — signed with HMAC-SHA256.
-
OAuth 2.0
Token-based authentication with scopes (read:sites, write:pages, manage:leads). Rotate tokens with one click.
-
Transparent rate limits
We agree your quota with you. X-RateLimit-* headers show what’s left.
-
OpenAPI specification
Full OpenAPI 3.1 spec — automatically generates type-safe clients in TypeScript, Python, Go, Ruby.
Example workflows.
Four examples of what you can build with the API.
-
CMS sync from Notion
A cron job reads your Notion pages and pushes the content into the CMS as mekyn blocks. Notion is the source, mekyn the front end.
-
Lead stream to Slack
The "lead.received" webhook pings a Slack channel with the lead details and a direct link to the lead in mekyn.
-
SEO report in Looker Studio
A daily cron pulls SEO metrics via the API and pushes them to BigQuery — Looker visualizes them.
-
Auto-deploy on git push
GitHub Action calls API endpoint "site.rebuild" — build starts, site is live in 30 seconds.
Example · cURL
curl https://api.mekyn.com/v1/sites \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"
# {
# "data": [
# { "id": "smith-plumbing", "domain": "smithplumbing.com", "status": "live" },
# { "id": "dr-jones-clinic", "domain": "drjonesclinic.com", "status": "live" }
# ],
# "meta": { "total": 2, "page": 1 }
# } Questions about the API
-
In which plans is the API included?
The API isn’t part of the standard Free, Start and Business plans. Read and write access, webhooks, rate limits and an SLA are arranged on request via our contact page.
-
Where do I find the documentation?
The OpenAPI spec is at api.mekyn.com/openapi.json, interactive docs at docs.mekyn.com/api. We set up API access in a personal onboarding session.
-
Are webhooks reliable?
Yes. On an error response (>=500 or timeout) we retry with exponential backoff for up to 24 hours. Failed payloads land in a dead letter queue you can view in the dashboard.
-
What about rate limits?
We set the limit together with you, and it can be raised. The X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset headers show the status. If you exceed it, you get HTTP 429 with Retry-After.
-
Is the API GDPR-compliant?
Yes. All endpoints run exclusively on EU servers. Audit logs of all API calls are kept for 90 days. Personal data in webhook payloads is encrypted at rest.
Ready for API access?
Available on request. Early access to new endpoints through personal onboarding.
Questions? Alya is here for you.
Connects your domain, publishes your website, checks the tech and fixes reported errors.
AI Alya: AI agent