> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kommo

> Instructions for integrating with Kommo. Obtain a Client ID and Client Secret from Kommo, then enter them on the integration screen to connect.

<Info>
  Translation Disclaimer: The documents herein have been machine translated for your convenience. While reasonable efforts are made to provide accurate translations, portions may be incorrect. If you would like to report a translation error or inaccuracy, please contact us.
</Info>

## Preparation

<Info>
  * An account with administrator privileges is required for integration.
</Info>

### How to log in

On [the Kommo login page](https://www.kommo.com/), enter your email address and password to log in.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/001.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=4dc73296969f90accd916f11e4747401" alt="Kommo login screen" width="1247" height="906" data-path="images/integrations/xjlzbaix6p-kommo/001.png" />

### How to obtain the Client ID and Client Secret

Choose an account that you own and manage, rather than an account that you were invited to or an account that is simply linked to your account.

\*For images, please select **itdev**.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/002.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=24997490d7b9b82c065eb562d6b0ba1b" alt="Account selection screen" width="2658" height="866" data-path="images/integrations/xjlzbaix6p-kommo/002.png" />

Click **Settings** > **Integration marketplace** > **+Create Integration**.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/003.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=64d3932d9a0b2505ec367a3c35991db7" alt="Create Integration screen" width="1895" height="990" data-path="images/integrations/xjlzbaix6p-kommo/003.png" />

Enter the following into the displayed input field and click **Save**.

1. **OAuth callback (redirect) URL**
   The URL will vary depending on your environment.
   * **Production environment (main):** `https://itmc.i.moneyforward.com/oauth/callback` or `https://itmc-sbn.i.moneyforward.com/oauth/callback`
   * **Test environment (staging):** `https://itmc.i.iggre.net/oauth/callback`
2. Grant access to "All" or "Account Data".
   Additionally, it is recommended to enter **"Admina"** as the Integration name.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/004.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=f839d4283cf49609171b81d74e760d95" alt="Create Integration input screen" width="1830" height="1232" data-path="images/integrations/xjlzbaix6p-kommo/004.png" />

Follow the instructions and copy the displayed **Integration ID**. This is your **Client ID**.

Next, click **Generate secret key**.

(If you have forgotten your secret key, please click **Regenerate secret key**.)

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/005.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=0811c57d16e8f37642a27fe7552a28ab" alt="Generate secret key screen" width="1820" height="1188" data-path="images/integrations/xjlzbaix6p-kommo/005.png" />

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/006.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=3d9fe525c0736b06c299ad9f5d8b7af6" alt="Secret key generation confirmation screen" width="496" height="220" data-path="images/integrations/xjlzbaix6p-kommo/006.png" />

Next, click **Confirm**, and the **Secret key (client secret)** will be displayed in the box below. Copy this key.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/007.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=bf2528171df7c435c7bc90224f9bb35d" alt="Secret key display screen" width="497" height="415" data-path="images/integrations/xjlzbaix6p-kommo/007.png" />

## Integration setup

On the integration screen, search for **Kommo**.

Enter your desired **workspace name**, the **client ID and client secret** obtained in the previous step, and click **"Connect"**.

<img src="https://mintcdn.com/moneyforwardi/Esz-euogDw_FDV-j/images/integrations/xjlzbaix6p-kommo/008.png?fit=max&auto=format&n=Esz-euogDw_FDV-j&q=85&s=8d26373d98ce772a59225d09e0659d21" alt="Kommo integration setup screen" width="476" height="611" data-path="images/integrations/xjlzbaix6p-kommo/008.png" />

Once the connection is successful, the registered user information will be displayed in the account list.

If the process does not complete successfully, please **edit** the status in the Integration screen and try the integration again.

If the issue persists, please contact us via chat.
