> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kintone (API Token) - How do I link my account?

## Overview

To authenticate with Kintone using an API token, you need:

1. **Subdomain** — the first part of your Kintone URL.
2. **Region** — the domain of your Kintone URL.
3. **API Token** — a token generated in the Kintone App you want to connect.

This guide will show you how to find and generate them.

### Prerequisites

* A Kintone environment with at least one App. You can get a free [Kintone developer license](https://kintone.dev/en/developer-license-registration-form/) or start a [free trial](https://www.kintone.com/en-us/trial/).

### Step 1: Find your subdomain and region

Sign in to Kintone and look at the URL in your browser, for example `https://example.kintone.com`:

* Your **subdomain** is the part before the domain, here `example`.
* Your **region** is the domain: `kintone.com`, or `cybozu.com` if your URL ends in `.cybozu.com`.

### Step 2: Generate an API token

An API token only works with the App it was generated in, and only for the permissions you tick.

1. Open the Kintone App you want to connect and click the **App settings** (gear) icon at the upper right of the View screen.

![Kintone App View screen with the App settings gear icon at the upper right](https://mintcdn.com/nango/48E_6RXML-VhOvGY/api-integrations/kintone-api-key/open_app_settings.png?fit=max\&auto=format\&n=48E_6RXML-VhOvGY\&q=85\&s=cd0682906fc5bc746a758f50b9eca057)

2. On the **App settings** tab, click **API token** under **Customization and integration**.

![Kintone App settings tab with API token under Customization and integration](https://mintcdn.com/nango/48E_6RXML-VhOvGY/api-integrations/kintone-api-key/app_settings_api_token.png?fit=max\&auto=format\&n=48E_6RXML-VhOvGY\&q=85\&s=381ed6b4b60c481ddfc2ff367f5566d5)

3. Click **Generate**, tick only the permissions you need (**View records** alone gives read-only access), copy the token, then click **Save**.

![Kintone API token screen with a generated token, the View records permission ticked and the Save button](https://mintcdn.com/nango/48E_6RXML-VhOvGY/api-integrations/kintone-api-key/generate_api_token.png?fit=max\&auto=format\&n=48E_6RXML-VhOvGY\&q=85\&s=950b577981d3fa9825b870803a5deadd)

4. Click **Update app** at the upper right and confirm. The token only works after the App is updated.

![Kintone App settings with the Update app button at the upper right](https://mintcdn.com/nango/48E_6RXML-VhOvGY/api-integrations/kintone-api-key/update_app.png?fit=max\&auto=format\&n=48E_6RXML-VhOvGY\&q=85\&s=09260518709436230fb1774955fc681f)

### Step 3: Enter your credentials in the Connect UI

1. Open the form where you need to authenticate with Kintone (API Token).
2. Enter your **Subdomain**, select your **Region**, and enter your **API Token**.
3. Submit the form. The connection is saved without checking the token: if the token is wrong, the first API request returns an authentication error.

![Kintone (API Token) Connect UI form with the Subdomain, Region and API Token fields](https://mintcdn.com/nango/48E_6RXML-VhOvGY/api-integrations/kintone-api-key/form.png?fit=max\&auto=format\&n=48E_6RXML-VhOvGY\&q=85\&s=ad8ae51e1635dcc0398244cb03dd1400)

You are now connected to Kintone (API Token).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.