microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
API Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Manual

Creating a Service

Last updated: 2026/04/24

Once you register an account and log in, you can create services at any time.

What is a Service?

A service is the largest management category in microCMS.
Concepts in microCMS, such as API, media, permission management, plans, and payment information, are generally linked to a single service.
With one account, you can create or join multiple services.
(Accounts that join a service are treated as members.)

Information

As an exception, in the case of the Enterprise plan, there may be contracts that allow multiple services to be used under a single plan.

Steps to Create a Service

This section explains the steps to create a new service.

First, access the top page of the management screen at https://app.microcms.io/ and click the [+ Add] button in the upper right corner of the screen.



When you click the [+ Add] button, a screen will appear where you can choose how to create the service.
There are two main ways to create a service.

  1. Create from scratch
  2. Select from a template


Below, we will explain each method.

If Creating from Scratch

Click [Create from scratch] on the service creation screen.
Then, the service information input screen will be displayed, where you need to enter the following:

  • Service Name
  • Service ID
Service Name

This is the name used to identify the service within the management screen.
It is recommended to enter the product name or organization name that you are considering for implementing microCMS.

Service ID

The Service ID is the value set in the URL of the management screen and the subdomain of the API endpoint.

Information

The service information input screen has default values filled in.
The service name and service ID can be changed later, so you can skip them with the default values as they are.


Finally, click the [Create Service] button. This completes the creation of the service.



From here, the service ID will be accessible as a subdomain on microcms.io.

Tips

At this point, the service plan will be the free Hobby plan.

When using a paid plan, please refer to the "Change Plan and Billing" procedure below.

Choosing from Templates

Click on [Choose from Template] on the service creation screen.
This will display the microCMS templates page.


Preparation

To use the microCMS templates, you need to log in to GitHub.
If you are not logged in yet, please log in from the following page.
Sign in to GitHub · GitHub

Once you are ready, follow the steps below to create a service.

1. Select the Template You Want to Use

From the list of templates, select the one you want to use.
Click [Details] on any template to display the template details page.

2. Click [Use This Template]

On the template details page, click [Use This Template].


3. Click [Link with GitHub]

On the GitHub repository settings screen, click [Link with GitHub].
If you are logged into GitHub, clicking [Link with GitHub] will link it in the background.

4. Enter Git Scope and Repository Name, then Click [Start Setup]

Next, enter the Git Scope and repository name.


  1. In Git Scope, specify the GitHub account or organization that will expand the template repository.
  2. Enter any name for the repository name.


Additionally, if you check [Create as a Private Repository], it will be generated as a private repository.

After entering the Git Scope and repository name, click [Start Setup].

5. Setup Completion

After a few seconds, the setup completion screen will be displayed.



This screen displays the service information of the newly created microCMS and the GitHub repository information.

1. microCMS Service Information

  • Service ID
  • API Key

2. GitHub Repository Information

  • Repository URL


At this point, if you access the management screen's top page (https://app.microcms.io/), you can access the newly created service.

Tips

After creating the service and repository, we will proceed to set up the development environment. For the specific flow after setting up the development environment, please refer to the blog below.

No problem for beginners! Let's start creating a site with the microCMS template|microCMS Blog

Contents

  • What is a Service?
  • Steps to Create a Service
  • If Creating from Scratch
  • Choosing from Templates
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.