Developers
The Produktly API,MCP server, and SDK
Produktly is a no-code tool with a full programmatic surface underneath it. Every widget you can build in the dashboard, you can also create, update, and measure over plain HTTP, from an AI assistant, or from your own JavaScript.
The Produktly API at a glance
Everything you need before writing the first request
| REST base URL | https://api.produktly.com/api/v1 |
|---|---|
| MCP endpoint | https://api.produktly.com/api/mcp |
| OpenAPI spec | https://produktly.com/docs/openapi.json |
| Authentication | API key as a Bearer token, same key for REST and MCP |
| Rate limit | 60 requests per minute per key, 300 per minute for /users |
| Response format | JSON. List endpoints return a data array plus pagination metadata |
List your product tours
curl https://api.produktly.com/api/v1/product-tours \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"id": 412,
"name": "New workspace walkthrough",
"active": true,
"stepCount": 4
}
],
"pagination": { "total": 12, "limit": 50, "offset": 0 }
}Developer resources
Every reference, spec, and SDK in one place
Produktly REST API
44 endpoints across product tours, checklists, smart tips, announcements, micro surveys, changelogs, roadmaps, feedback widgets, NPS widgets, tags, analytics, and identified users. Create and update widgets, then read back how they performed.
API referenceOpenAPI specification
A self-contained OpenAPI 3.1 document, served without authentication. Point your client generator, Postman, or an AI agent straight at it. Also available from the API itself at https://api.produktly.com/api/v1/openapi.json.
Download the specAPI authentication
Generate an API key in Settings, send it as a Bearer token, and you are done. The docs cover scopes, the read, write, and publish model, every error code, and how rate limit headers work.
Authentication docsProduktly MCP server
A hosted Model Context Protocol server over streamable HTTP, so Claude Code, Cursor, Windsurf, and VS Code can read your Produktly data and build widgets for you. It uses the same API key as REST.
About the MCP serverProduktly agent skill
A downloadable skill that teaches a coding agent the whole flow: installing the snippet for your framework, wiring up user identification, adding stable data attributes for targeting, and authoring widgets that survive a redesign.
Agent skill docsJavaScript client SDK
Bundled with the install snippet. Call identifyUser, startTour, startChecklist, openChangelog, markChecklistStepCompleted, and more from your own code to trigger widgets on any event you choose.
Client SDK docsWebhooks
Forward Produktly events to any HTTPS endpoint as JSON. Use them to pipe feedback, NPS responses, and feature requests into your own systems, or into Zapier and Pabbly Connect.
Webhook docsIdentity verification
Sign identifyUser calls with an HMAC-SHA256 hash generated on your backend, so nobody can impersonate one of your users from the browser console. Required for authenticated roadmaps.
Identity verification docsProduktly API questions
- Does Produktly have an API?
- Yes. Produktly has a REST API at https://api.produktly.com/api/v1 with 44 endpoints covering product tours, checklists, smart tips, announcements, micro surveys, changelogs, roadmaps, feedback widgets, NPS widgets, tags, analytics, and identified users. The full reference is at https://produktly.com/docs/api-reference/.
- Where is the Produktly OpenAPI spec?
- The OpenAPI 3.1 specification is published at https://produktly.com/docs/openapi.json and served by the API itself at https://api.produktly.com/api/v1/openapi.json. Both are public and need no authentication, so you can generate a client or hand the URL to an AI agent directly.
- How do I authenticate with the Produktly API?
- Generate an API key under Settings, API keys in your Produktly dashboard, then send it on every request as an Authorization: Bearer header. The same key authenticates the MCP server. Full details, including scopes and error codes, are at https://produktly.com/docs/docs/api/authentication.
- Does Produktly have an MCP server?
- Yes. The Produktly MCP server runs at https://api.produktly.com/api/mcp using the streamable HTTP transport. It works with Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, and VS Code, and it authenticates with the same API key as the REST API.
- What are the Produktly API rate limits?
- Each API key is limited to 60 requests per minute, with a separate bucket of 300 requests per minute for the /users endpoints so backend syncs do not exhaust your quota. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, and a 429 response includes Retry-After.
- Can an AI agent build Produktly widgets for me?
- Yes. Connect the MCP server and your assistant can create and edit product tours, checklists, smart tips, announcements, micro surveys, NPS widgets, feedback widgets, and changelog posts. Add the Produktly agent skill and a coding agent can also install the snippet, wire up user identification, and add stable selectors in your codebase.