> ## 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.

# Lark

> Steps to integrate with Lark.

<Info>
  An administrator account is required for the integration.
</Info>

## Prerequisites

### How to Log In

Go to the [Lark login page](https://open.larksuite.com/app) and enter your email address and password to log in.

<img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781241827400.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=333b563fd43409a6745912f0dfcf1a47" alt="Lark login screen" width="514" height="630" data-path="images/integrations/xei3b539al/1781241827400.png" />

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

1. Click **Create Custom App**.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781242180466.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=ba85c7443c4b35e1732853872f433ec7" alt="Create Custom App button" width="2446" height="286" data-path="images/integrations/xei3b539al/1781242180466.png" />

2. Enter an app name, description, and icon, then click **Create**.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781242259258.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=18d0755f36ab23675b7c4e9fe775999b" alt="App creation form" width="1662" height="1494" data-path="images/integrations/xei3b539al/1781242259258.png" />

3. Click **Permissions & Scopes** in the sidebar.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781242737514.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=25ca40209be627a5ca9fc1ec342df6be" alt="Permissions & Scopes menu" width="557" height="1364" data-path="images/integrations/xei3b539al/1781242737514.png" />

4. Click **Batch import/export scopes**.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781242799149.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=eaa7e3377a857f1bae600f4607387b95" alt="Batch import/export scopes button" width="2138" height="902" data-path="images/integrations/xei3b539al/1781242799149.png" />

5. Enter the following JSON to add the scopes.

   ```json theme={null}
   {
     "scopes": {
       "tenant": [
         "contact:contact",
         "contact:contact.base:readonly",
         "contact:department.base:readonly",
         "contact:user.base:readonly",
         "contact:user.department:readonly",
         "contact:user.email:readonly",
         "contact:user.id:readonly",
         "tenant:tenant:readonly"
       ]
     }
   }
   ```

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781860174369.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=f00750b8cc2ece73ae3a5f02169d75d8" alt="Scope JSON input screen" width="1706" height="1316" data-path="images/integrations/xei3b539al/1781860174369.png" />

6. Confirm that the scopes were added.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781861286236.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=f74a4bb7649ed73dd1068d6fb3511785" alt="Scope confirmation screen" width="1700" height="904" data-path="images/integrations/xei3b539al/1781861286236.png" />

7. Click **Configure** for the data scope, select **All members**, and save.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781243092339.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=b990f28460aaf1cb4e6a43b8c70751ef" alt="Data scope configuration screen" width="1806" height="1976" data-path="images/integrations/xei3b539al/1781243092339.png" />

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1781861357441.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=d6d77913236d12e415c1480d3300b718" alt="All members selection screen" width="1320" height="344" data-path="images/integrations/xei3b539al/1781861357441.png" />

8. Create a new version from **Version Management & Release**.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1785305982122.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=6aac2e2abffb5eeb4dc865f02549d90b" alt="Version Management & Release screen" width="2156" height="290" data-path="images/integrations/xei3b539al/1785305982122.png" />

9. Enter the app version information.

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1785306551846.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=25a2e1c97eeaf68db1b10f9501e90b4e" alt="App version input form" width="378" height="168" data-path="images/integrations/xei3b539al/1785306551846.png" />

10. Set the availability scope to **All members**.

    <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1785306564345.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=069b419cfdbc10832ecf537760b364f2" alt="Availability scope screen" width="1604" height="516" data-path="images/integrations/xei3b539al/1785306564345.png" />

11. Click **Submit for release**.

    <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1785307008479.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=b1cd4ad72124647bbacf6ae16ef0954a" alt="Submit for release confirmation screen" width="840" height="404" data-path="images/integrations/xei3b539al/1785307008479.png" />

12. Copy and save the **App ID** and **App Secret** from **Credentials & Basic Info**. These correspond to the **Client ID** and **Client Secret**, respectively.

    <img src="https://mintcdn.com/moneyforwardi/bOeTTmog4pRzqOpS/images/integrations/xei3b539al/1785307020454.png?fit=max&auto=format&n=bOeTTmog4pRzqOpS&q=85&s=bb5fdb7e02682896a88214669f1b8cfe" alt="Credentials & Basic Info screen" width="2734" height="374" data-path="images/integrations/xei3b539al/1785307020454.png" />

## Integration Setup

1. In the integration screen, search for **Lark**.

2. Enter the following values, then click **Connect**.

   * **Workspace Key**: Any name (e.g., company name)
   * **Client ID**: The **App ID** obtained in the previous step
   * **Client Secret**: The **App Secret** obtained in the previous step

   <img src="https://mintcdn.com/moneyforwardi/nDPQfgFue6GiSlDU/images/integrations/xei3b539al/1785286796777.png?fit=max&auto=format&n=nDPQfgFue6GiSlDU&q=85&s=a1b3778a252a909410b0b6fb27ef7a44" alt="Integration settings screen" width="666" height="868" data-path="images/integrations/xei3b539al/1785286796777.png" />

3. Once the Lark integration is successful, the registered user information will appear in the account list. If the integration does not complete successfully, first try the steps in [Troubleshooting SaaS Integration Failures](/en/it-management/saas-management/93nahw45is-trouble). If the issue persists, check the [information to provide](/en/it-management/saas-management/93nahw45is-trouble#info-to-provide) and contact the [support desk](/en/contact-support).
