> For the complete documentation index, see [llms.txt](https://limechatai.gitbook.io/limechat-product-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://limechatai.gitbook.io/limechat-product-guide/whatsapp-marketing/flows/action-nodes/read-next-entry-from-sheet.md).

# Read Next Entry From Sheet

**Node Name:**\
Read Next Entry From Sheet

***

**What it does:**\
Fetches the next available row (entry) from a connected Google Sheet and returns it for use in the flow. It keeps track of progress so each time the node runs, it reads the next row sequentially.

***

**When to Use:**

* When you want to distribute leads, coupon codes, or data stored in a Google Sheet one-by-one<br>
* For sequential allocation use cases (e.g., assigning unique codes, numbers, or tasks)<br>
* When running campaigns where each user should get a unique entry from a list<br>
* When managing limited inventory stored in a sheet (e.g., vouchers, invites)<br>

***

**UI Inputs:**

* **GSheet URL**
  * Type: URL<br>
  * Required: Yes<br>
  * Description: Link to the Google Sheet from which entries will be read<br>
  * Special Behavior: Must be a valid and accessible Google Sheet<br>
* **Emails to CC**
  * Type: List (Text / Email IDs)<br>
  * Required: Yes<br>
  * Description: Email addresses to notify when sheet entries are running low<br>
  * Special Behavior: Accepts multiple emails<br>
* **Alert Before Rows Left**
  * Type: Number<br>
  * Required: Yes<br>
  * Description: Threshold for remaining rows at which alert emails will be triggered<br>
  * Special Behavior: Default is 75<br>

***

**Outputs:**

* **successful**
  * Type: Boolean<br>
  * Meaning:
    * true → Entry successfully fetched<br>
    * false → Failed to fetch entry (e.g., no rows left or error)<br>
* **next entry**
  * Type: Text<br>
  * Meaning: The next row’s data fetched from the sheet<br>

***

**Requirements:**

* **Supported Events:**
  * All events (*all*)<br>
* **Required Integrations:**
  * None explicitly required (but Google Sheet must be accessible via URL)<br>

***

**Notes (if anything unclear):**

* The node internally maintains a pointer (cursor), so entries are not repeated<br>
* If the sheet runs out of rows, the node may return failure<br>
* Alert emails are triggered when remaining rows fall below the defined threshold<br>
* Ensure the Google Sheet has proper sharing permissions (accessible to the system)