Skip to main content

Documentation Index

Fetch the complete documentation index at: https://kratecms.mintlify.app/llms.txt

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

This guide walks you through logging into KrateCMS for the first time, orienting yourself in the admin dashboard, creating and publishing a post, generating an API token, and making your first API call. By the end you will have live content and a working integration point for any external tool.
1

Set your password and sign in

Your KrateCMS site lives at a subdomain provided in your welcome email — for example, https://yoursite.kratecms.com.Open the welcome email and click the set password link inside. KrateCMS does not send temporary passwords — the link opens a one-time password setup form where you choose your own. Pick a strong password and submit the form; KrateCMS checks every password against the Have I Been Pwned database and will reject any password found in a known data breach.
If you cannot find your welcome email, ask your administrator to resend your invitation from your user profile in Users → (your name) → Resend Invite.
After setting your password you are signed in and land on the admin dashboard at /admin.
2

Explore the admin dashboard

The dashboard gives you an at-a-glance view of your site’s activity. From the left sidebar you can navigate to every section of the admin:
  • Posts — create, edit, and publish written content
  • Pages — build structured pages with the block editor
  • Users — manage team members and their roles (admin and above)
  • Settings — configure your site’s branding, content rules, and security
A setup checklist appears at the top of the dashboard on new sites. Work through it to complete your initial configuration: set your site name, upload a logo, and configure your contact form.
Your sidebar may show fewer items depending on your role. Contributors and authors see Posts and their Profile; editors and managers also see Pages; admins see the full sidebar including Settings and Users.
3

Create and publish your first post

Navigate to Posts → New Post, or go directly to /admin/posts/create.Fill in the following fields:
  • Title — the headline for your post
  • Body — write and format your content using the TinyMCE rich-text editor; use the toolbar to add headings, links, lists, and inline images
  • Featured Image — upload an image or use the AI image generator (click the sparkle icon in the featured image panel) to create one from a prompt
  • Category — choose from Text, Audio, Video, or Uncategorized
  • Visibility — set to Public so anyone can read it, or Members Only to restrict it to logged-in users
  • Publish Date — defaults to now; set a future date to schedule the post
When you are ready, click Publish. Your post is immediately live at its slug-based URL (for example, https://yoursite.kratecms.com/posts/your-post-title).
Save a draft first by clicking Save Draft if you want to review your post before it goes live. You can return to it any time from the Posts index.
4

Get an API token

To authenticate write operations against the API, you need a personal access token.Navigate to /admin/tokens (super-admin access required). Click Create Token, give it a descriptive name (for example, My Integration), and click Generate.Copy the token immediately — it is only displayed once. Store it in a secure location such as a password manager or your application’s secrets store.
Treat your API token like a password. Anyone who holds it can create, update, and delete posts on your behalf. Revoke it from /admin/tokens if it is ever exposed.
5

Make your first API call

The KrateCMS API is available at /api/v1/ on your subdomain. Reading published posts does not require authentication, so you can test immediately with curl:
curl https://yoursite.kratecms.com/api/v1/posts
You will receive a JSON array of your published posts. To create a post programmatically, include your token in the Authorization header:
curl -X POST https://yoursite.kratecms.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My First API Post",
    "content": "<p>Created via the KrateCMS API.</p>",
    "status": "published"
  }'
A successful response returns the created post object with its id, slug, and published_at timestamp.
A Postman collection covering all available endpoints is available in the API documentation. Import it to explore every route without writing curl commands by hand.

​
What’s next

Now that your first post is live and you have a working API token, explore the rest of KrateCMS:

Build a page

Use the block editor to create landing pages, about pages, and more.

Customize your brand

Set your colors, logo, and typography from the Brand settings panel.

Manage roles

Add editors, authors, and contributors and assign them the right roles.

Explore the API

Read the full API reference and download the Postman collection.