Frequently Asked Questions

Common questions about Kopra. Can't find your answer? hello@kopra.dev

What is Kopra?

Kopra is custom fields as a service. It lets you add custom fields to your SaaS product without building the infrastructure yourself. Your customers can configure their own fields through an embeddable UI, and you stay focused on your core product.

How long does integration take?

Most teams integrate in an afternoon. Install the TypeScript SDK (npm install @kopra-dev/sdk), add 5 lines of code to load the field editor, and your app has custom fields. No database migrations, no schema changes on your side.

What tech stacks does Kopra support?

Any stack that can make HTTP requests. The TypeScript SDK works with React, Next.js, Vue, Svelte, or any JavaScript framework. The REST API (26 endpoints) works with any backend language. There is also an MCP server for AI agents.

How does multi-tenant isolation work?

Every API request is scoped to a clientId (your account) and tenantId (your customer). You do not need to create tenants in advance - just use your customer's unique ID as the tenantId and Kopra provisions the tenant automatically on first use. Data is isolated at the database level. One tenant cannot see another tenant's fields or values. Global fields (defined by you) are visible to all tenants. Tenant fields (defined by your customer) are private to that tenant.

What field types are supported?

Kopra supports 9 field types: string, textarea, number, boolean, date, select, multiselect, email, and url. Each field can have validation rules (required, min/max length, min/max value, regex pattern, options list) and UI hints (placeholder, help text).

Can my customers create their own fields?

Yes. Kopra has an embeddable tenant configuration panel where your customers add, edit, and delete their own custom fields. You control the field limit per tenant through your plan or per-token settings. No engineering tickets needed.

Is Kopra white-label? How does the embedded UI look in my product?

Fully white-label. There is no Kopra branding anywhere in the embedded UI. The SDK accepts a theme object that controls every visual element: labels, inputs, selects, textareas, buttons, and field containers. You pass your own colors, fonts, spacing, and border radius. Your users see your design, not ours. The embed also inherits your page's font family by default.

Is there a free tier?

Yes. The free plan includes 3 field groups, 10 tenants, 50 field values per tenant, and 5,000 API calls per month. No credit card required. It is enough to build a real proof of concept, not just a hello-world test.

How much does Kopra cost?

Free for evaluation. Starter plan at €29/month for products with early customers (10 field groups, 100 tenants, 50K API calls). Pro plan at €99/month for growing products (25 field groups, 500 tenants, 200K API calls). Enterprise pricing is custom.

What happens when I hit my plan limits?

API calls that exceed your monthly limit return HTTP 429. Creating a field group, tenant, or field value beyond your plan limit returns HTTP 403 with a clear error message. Your existing data stays accessible. The dashboard shows usage warnings at 75% and 90% so you can upgrade before hitting the wall. API call counters reset monthly. All other limits are cumulative.

How does Kopra compare to building custom fields in-house?

Building custom fields in-house typically takes 3-6 months of engineering time and costs €100K-€200K when you include design, testing, and ongoing maintenance. Kopra starts at €0 and takes an afternoon to integrate. The total cost of ownership for building is 3-4x the original estimate.

What happens to my data if I leave Kopra?

Your data belongs to you. You can export all field groups, field definitions, and field values via the REST API or CSV export at any time. If you close your account, we retain data for 30 days before permanent deletion.

Can I offer different field limits to my customers based on their plan?

Yes. When generating an embed token, pass a fieldLimit parameter to control how many custom fields that tenant can create. For example, your free-tier customers get 5 fields, your pro customers get 20. The limit is enforced server-side. This lets you tier Kopra features by your own pricing plans.

Does Kopra have webhooks?

Yes. Kopra fires webhooks for field group, global field, tenant field, and field value changes. Webhooks are cryptographically signed for verification. Failed deliveries are retried automatically.

What is the MCP server?

Kopra has a Model Context Protocol (MCP) server that lets AI agents manage custom fields programmatically. Install with npx @kopra-dev/mcp and configure with your API key. It exposes 16 tools for field group CRUD, tenant field management, field value read/write, and webhook management.

Where is Kopra hosted?

Kopra runs on European cloud infrastructure. All API traffic is encrypted in transit via TLS. See the security page for details.