{"id":36225,"date":"2026-01-28T19:42:53","date_gmt":"2026-01-28T12:42:53","guid":{"rendered":"https:\/\/dps.media\/huong-dan-dang-ky-form-lark-n8n\/"},"modified":"2026-01-28T20:16:32","modified_gmt":"2026-01-28T13:16:32","slug":"huong-dan-dang-ky-form-lark-n8n","status":"publish","type":"post","link":"http:\/\/dps.media\/en\/huong-dan-dang-ky-form-lark-n8n\/","title":{"rendered":"Guide to Registering Form Lark in n8n \u2013 3 Simple Steps 2026"},"content":{"rendered":"

Introduction to Lark Form subscription in n8n<\/h2>\n

Integrating Lark Forms with n8n opens up many possibilities for automating your workflow. When a new form is submitted or an approval is created, n8n can automatically receive notifications and process data according to the workflow you have set up. However, to establish this connection, you need to correctly follow the procedure for subscribing a form with the Lark API.<\/p>\n

In this article, I will guide you through 3 detailed basic steps to subscribe a new Lark Form. Once completed, you will be able to reuse this process for any future forms without having to figure it out from scratch.<\/p>\n

1. Get the Approval Code (Form Identifier)<\/h2>\n

The Approval Code is the unique ID of each form template in the Lark system. This is the most important information so that Lark knows which form n8n wants to \u201clisten\u201d for events from. Each form will have a unique code, and you need to get this exact code to ensure the webhook works correctly.<\/p>\n

How to get the Approval Code<\/h3>\n

Step 1:<\/strong> Log in to Lark and access your Approval or Forms management section.<\/p>\n

Step 2:<\/strong> Open the form you want to integrate with n8n. You can open the form in Design mode or in the Approval Management section.<\/p>\n

Step 3:<\/strong> Look at the browser's URL address bar. The Approval Code is usually located right in the URL, possibly appearing after the parameter definitionCode=<\/code> or located between forward slashes.<\/p>\n

Specific example<\/h3>\n

Suppose the URL of the form you are opening is:<\/p>\n

https:\/\/example.larksuite.com\/approval\/definitionCode=8C49EDF7-8116-448C-8131-83D2071B632E<\/code><\/p>\n

Then your Approval Code is: 8C49EDF7-8116-448C-8131-83D2071B632E<\/code><\/p>\n

Copy this code and save it in a safe place; you will need to use it in step 3.<\/p>\n

2. Get the Tenant Access Token (Authentication Key)<\/h2>\n

The Tenant Access Token is an authentication string that helps the Lark API confirm that your application (in this case, the Approval-N8N app) has the right to perform operations with the form. This is the information that many people often overlook or do not know how to obtain when setting up for the first time.<\/p>\n

Why is a Tenant Access Token needed?<\/h3>\n

Lark uses the OAuth 2.0 mechanism to secure the API. Every request sent to the Lark API needs a valid token in the header for authentication. If the token is missing or invalid, the API will return a 401 Unauthorized error.<\/p>\n

Fastest way to get the Tenant Access Token<\/h3>\n

Method 1: Use Lark API Explorer (Recommended for beginners)<\/strong><\/p>\n

    \n
  1. Access Lark API Explorer<\/strong> (usually located at https:\/\/open.larksuite.com\/api-explorer<\/code>).<\/li>\n
  2. In the top left corner, select the correct App you created (e.g., Approval-N8N).<\/li>\n
  3. Lark will automatically display a token string starting with t-<\/code> in the side pane. This is your Tenant Access Token.<\/li>\n
  4. Copy this entire token string (including the t-<\/code>).<\/li>\n<\/ol>\n

    Method 2: Call the API to get the Token (For experienced users)<\/strong><\/p>\n

    You can also directly call the endpoint \/auth\/v3\/tenant_access_token\/internal<\/code> with the App ID and App Secret to get the token. However, this method is more complex and requires you to manage App credentials.<\/p>\n

    Important note about Token expiration<\/h3>\n

    This token is only valid for 2 hours.<\/strong> After 2 hours, the token will expire and you need to get a new one. This is why in the \u201cQuick Tip\u201d section at the end of the post, I will guide you on how to automate this token retrieval so you don't have to do it manually every time.<\/p>\n

    If you are setting up for the first time and just want to test, manually getting the token from API Explorer is enough. But if you need to register multiple forms or want the system to run long-term, refer to the automation section at the end of the post.<\/p>\n

    3. Configure the HTTP Request Node in n8n<\/h2>\n

    Once you have both pieces of important information (Approval Code and Tenant Access Token), you will use them to configure an HTTP Request node in n8n. This node will send a subscribe command to the Lark API, requesting Lark to send webhooks to n8n whenever an event occurs with the form.<\/p>\n

    Detailed configuration steps<\/h3>\n

    Step 1: Create a new HTTP Request node in n8n<\/strong><\/p>\n

    In your workflow, add a new node and select the type HTTP Request<\/strong>.<\/p>\n

    Step 2: Set the Method<\/strong><\/p>\n

    Select the method as POST<\/strong>. This is the standard method for sending a subscribe command to the Lark API.<\/p>\n

    Step 3: Set the URL<\/strong><\/p>\n

    The URL will look like this:<\/p>\n

    https:\/\/open.larksuite.com\/open-apis\/approval\/v4\/approvals\/{{Approval_Code}}\/subscribe<\/code><\/p>\n

    Where you need to replace {{Approval_Code}}<\/code> with the Approval Code you obtained in step 1.<\/p>\n

    Example:<\/strong> If your Approval Code is 8C49EDF7-8116-448C-8131-83D2071B632E<\/code>, then the full URL will be:<\/p>\n

    https:\/\/open.larksuite.com\/open-apis\/approval\/v4\/approvals\/8C49EDF7-8116-448C-8131-83D2071B632E\/subscribe<\/code><\/p>\n

    Step 4: Set the Headers<\/strong><\/p>\n

    The Headers section is very important because it contains the authentication information. You need to add a new header with the following information:<\/p>\n

      \n
    • Name:<\/strong> Authorization<\/code><\/li>\n
    • Value:<\/strong> Bearer [Tenant_Access_Token]<\/code><\/li>\n<\/ul>\n

      Extremely important note:<\/strong> There must be the word Bearer<\/code> (capitalized B) and a space before the token string. Many people make the mistake of forgetting the space or misspelling Bearer, leading to the API returning an authentication error.<\/p>\n

      Example:<\/strong> If your token is t-g1044ghHGHJKL...<\/code>, then the value in the header will be:<\/p>\n

      Bearer t-g1044ghHGHJKL...<\/code><\/p>\n

      Step 5: Test and Execute<\/strong><\/p>\n

      After completing the configuration, press Execute to test. If everything is correct, you will receive a success response from the Lark API, confirming that the form has been successfully subscribed.<\/p>\n

      \ud83d\udca1 Quick Tip: Automate Token retrieval for next time<\/h2>\n

      As mentioned, the Tenant Access Token is only valid for 2 hours. If you need to register many forms or want the system to automatically renew the token, you should create a separate workflow to automate this process.<\/p>\n

      Automatic workflow consists of 2 nodes<\/h3>\n

      Node 1: Get Tenant Access Token automatically<\/strong><\/p>\n

      Create an HTTP Request node with the following configuration:<\/p>\n

        \n
      • Method:<\/strong> POST<\/li>\n
      • URL:<\/strong> https:\/\/open.larksuite.com\/open-apis\/auth\/v3\/tenant_access_token\/internal<\/code><\/li>\n
      • Body (JSON):<\/strong><\/li>\n<\/ul>\n
        {\n  \"app_id\": \"YOUR_APP_ID\",\n  \"app_secret\": \"YOUR_APP_SECRET\"\n}<\/code><\/pre>\n
        This node will return a new token every time it is executed. You can save this token into a variable to use for the next node.<\/p>\n
        Node 2: Use Token to Subscribe Form<\/strong><\/p>\n
        Use the token from Node 1 to send the subscribe command as instructed in step 3. You can use the expression {{$node[\"Node1\"].json[\"tenant_access_token\"]}}<\/code> to get the token from the output of Node 1.<\/p>\n
        Benefits of automation<\/h3>\n
        With this workflow, every time you need to register a new form, you only need to:<\/p>\n
          \n
        1. Get the Approval Code from the URL (30 seconds)<\/li>\n
        2. Paste the Approval Code into Node 2 (10 seconds)<\/li>\n
        3. Execute workflow (5 seconds)<\/li>\n<\/ol>\n
          No need to go to API Explorer to get the token manually anymore!<\/p>\n
          Conclusion<\/h2>\n
          Subscribing to a Lark Form in n8n is not complicated if you master 3 basic steps: Get the Approval Code, get the Tenant Access Token, and configure the HTTP Request node. Once set up, you can leverage the power of n8n to automate all processes related to your forms.<\/p>\n
          If you encounter difficulties during the setup process or want me to send the automatic token retrieval workflow template, please leave a comment below!<\/p>\n