> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Kintone (Japan)

> Steps to integrate with Kintone.

## Supported Features

<Badge color="blue">Account Deletion</Badge> <Badge color="blue">Account Creation</Badge>

<Info>
  * If Basic authentication is configured, the Basic authentication login name and password are required during integration.
  * Common administrator privileges are required for integration.
</Info>

## Prerequisites

### If You Are Using 2FA (Two-Factor Authentication)

As described in Cybozu's "[When two-factor authentication is configured (external site)](https://cybozu.dev/ja/common/docs/user-api/overview/authentication/#2fa)", users with [two-factor authentication](https://jp.cybozu.help/general/ja/id/02042.html) enabled cannot execute REST API with password authentication.

Please prepare a dedicated integration user with two-factor authentication disabled.

### How to Log In to Kintone

1. On the [Kintone login page](https://www.cybozu.com/jp/login/), enter your subdomain and click the button to proceed to the login screen.

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1658382553443-image.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=be2756da2ea79c122ba666596bf951aa" alt="Kintone login screen" width="1333" height="639" data-path="images/integrations/zdvaxq9b9x/1658382553443-image.png" />

2. Enter your email address and password to log in.

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1658383686382-image.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=b1ba33f13003ccc0be31c45596aa00f3" alt="Kintone login authentication screen" width="864" height="638" data-path="images/integrations/zdvaxq9b9x/1658383686382-image.png" />

<h3 id="workspace-key">
  How to Obtain the Workspace Key
</h3>

After logging in to Kintone, **part of the URL** on the next screen is your workspace key — save it.

`https://{workspace key}.cybozu.com`

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1666660713932-image.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=1f39522d2767a9ba485eea9d335c11b2" alt="Workspace key confirmation screen" width="912" height="402" data-path="images/integrations/zdvaxq9b9x/1666660713932-image.png" />

### How to Obtain the API Key

There are two integration methods: the "API" tab and the "ID/Password" tab.

To integrate using the "API" tab, refer to [Generate an API token (external site)](https://jp.kintone.help/k/ja/app/api/api_token) for setup instructions.

## Integration Setup

1. In the Admina integration screen, search for **kintone (Japan)**.

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1648114505883-image.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=492dae61d6c80984019bc536719f9a46" alt="Search for kintone in Admina integration screen" width="855" height="375" data-path="images/integrations/zdvaxq9b9x/1648114505883-image.png" />

2. There are two integration methods: the "API" tab and the "ID/Password" tab. Follow the steps for your chosen method.

   **To integrate using the "API" tab:** Enter the following and click \[Connect].

   * **Workspace Name:** Enter any name you prefer.
   * **Workspace Key:** Enter the workspace key obtained in [How to Obtain the Workspace Key](#workspace-key).
   * **API Key:** Enter the generated API token. For details, refer to [Generate an API token (external site)](https://jp.kintone.help/k/ja/app/api/api_token).

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1775700199268-api-tab.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=a449e7965c2fc4bb2c819f89d75b65fc" alt="API integration screen" width="750" height="1028" data-path="images/integrations/zdvaxq9b9x/1775700199268-api-tab.png" />

**To integrate using the "ID/Password" tab:** Enter the following and click \[Connect].

* **Workspace Name:** Enter any name you prefer.
* **Workspace Key:** Enter the workspace key obtained in [How to Obtain the Workspace Key](#workspace-key).
* **Username:** Enter the common administrator's email address.
* **Password:** Enter the common administrator's password.
* **Username (Basic Auth):** If Basic authentication is configured, enter the Basic authentication login name.
* **Password (Basic Auth):** If Basic authentication is configured, enter the Basic authentication password.

<img src="https://mintcdn.com/admina-sbn/EytLyhMZXkzPYa2d/images/integrations/zdvaxq9b9x/1775700117633-basic-auth.png?fit=max&auto=format&n=EytLyhMZXkzPYa2d&q=85&s=ee858ad1d13fd1c92b1beb7d5bafd2dd" alt="ID/Password integration screen" width="666" height="1332" data-path="images/integrations/zdvaxq9b9x/1775700117633-basic-auth.png" />

3. Once the Kintone integration is successful, the registered user information will appear in the account list.

If the process does not complete successfully, click **Edit** from the Status tab on the integration screen and try connecting again.

If the issue persists, please contact us via chat.

For an overview of the Kintone integration, see the [integration page](http://admina.moneyforward.com/en/integrations/kintonejp).