Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/PloutusLab/krafta-web/llms.txt

Use this file to discover all available pages before exploring further.

The Krafta Creator Program lets designers and independent artists monetize their artwork through a print-on-demand storefront built directly into the Krafta platform. Once your account is upgraded to the CREADOR role, your designs appear on a public storefront at /creator/[slug] where customers can browse, buy, and receive fully produced and shipped items — with Krafta and its allied workshops handling every step of production and delivery.

​
How the creator model works

A creator is a registered user with the CREADOR role who owns a storefront and has at least one published design listing. The data model has four layers:
ModelKey fieldsPurpose
CreatoruserId, approvedLinks a User to creator status; must be approved: true by an admin
CreatorStoreslug, displayName, bio, activeThe public-facing storefront identity and URL
CreatorDesigntitle, fileUrl, approvedAn uploaded artwork file; must be approved: true before it can be listed
CreatorDesignListingcreatorDesignId, variantId, retailPrice, activeAttaches an approved design to a specific product variant at a creator-set price
The retailPrice on a CreatorDesignListing must be greater than or equal to the basePrice of the linked ProductVariant. The difference between those two values is the creator’s royalty on each sale. 
retailPrice − ProductVariant.basePrice = creator royalty per unit
Earned royalties are recorded as CreatorEarning entries (status PENDING or PAID) and grouped into CreatorPayout records that carry a payment reference and optional receipt URL.

​
Public storefront

Every creator gets a permanent storefront at: 
/creator/[slug]
The storefront displays the creator’s displayName, bio, and all active listings. A listing only appears to the public when all four of the following conditions are met:
  • Creator.approved is true
  • CreatorDesign.approved is true
  • CreatorDesignListing.active is true
  • The linked ProductVariant.active is true

​
Account upgrade endpoint

Upgrading a CLIENTE account to CREADOR is done with a single API call. The endpoint verifies the session token, checks that the chosen slug is unique across all creators, updates the user’s role, creates the CreatorStore record, and re-issues the JWT cookie. 
POST /api/auth/convert-creator
Content-Type: application/json

{
  "displayName": "Arte Digital Venezuela",
  "slug": "arte-digital-venezuela",
  "bio": "Diseños originales inspirados en la cultura venezolana."
}
displayName and slug are required. bio is optional. The slug is lowercased and stripped of any character that is not a letter, digit, hyphen, or underscore before being saved. If the slug is already taken, the API returns 400 with the message "El enlace único (slug) ya está en uso por otro creador.". Response (200) 
{
  "success": true,
  "user": {
    "id": "...",
    "email": "creador@ejemplo.com",
    "role": "CREADOR",
    "creatorStore": {
      "displayName": "Arte Digital Venezuela",
      "slug": "arte-digital-venezuela",
      "bio": "Diseños originales inspirados en la cultura venezolana."
    }
  }
}

​
Approval flow

Both the creator account and each individual design go through a manual admin review before going live:
  1. Creator approval — an admin sets Creator.approved = true on the creator’s record.
  2. Design approval — for each uploaded CreatorDesign, an admin sets CreatorDesign.approved = true.
Neither step is automatic. Listings created with unapproved designs or under an unapproved creator account remain hidden from the public storefront until both reviews pass.

​
Getting started

1

Register a Krafta account

Go to /creator and create a new account using the registration form. New accounts start with the CLIENTE role.
2

Convert to creator

Inside the account portal, open the Diseñar y Vender tab and fill in your store name, URL slug, and optional bio. Submit the form to call POST /api/auth/convert-creator. Your role is upgraded to CREADOR immediately and you are redirected to the creator dashboard.
3

Submit designs for approval

From the creator dashboard, open the canvas editor and create a design on a base product. Each submitted CreatorDesign starts with approved: false and enters the admin review queue.
4

Publish listings

Once a design is approved, link it to a product variant by completing the publish wizard: set a retailPrice that is at or above the variant’s basePrice and choose a print provider workshop. The listing becomes visible on your public storefront at /creator/[slug].
5

Earn royalties

When a customer purchases a listing, a CreatorEarning record is created with status PENDING. Earnings are batched into a CreatorPayout and transferred to you at the end of each month using the bank details saved in your store settings.

Build docs developers (and LLMs) love

Get started for freeTalk to us