Get All

With this operation, the automation can obtain a complete list of people registered in the system, which is useful for data analysis, segmentation or bulk actions.

The Get All People operation retrieves a list of people from your contact database. By default, the list is paginated to ensure good performance, even with a large volume of data.

This action is extremely versatile, as it allows applying various filters to segment the search, such as searching for people created within a specific period, with a specific status, associated with an organization, among many other options.

The result is a collection (array) of objects, where each object represents a person that meets the search criteria.

How to Configure

1. In Hablla Studio, add the "People" block to your automation flow.

2. In the "Operation" field, select the "Get All" option.

3. Optionally, click "Add Filter" to specify search parameters and refine your results.

---

Available Filters

You can combine the filters below to create precise queries.

Filter	Type	Description
Page (page)	Number	The page number of results you want to retrieve. The default is 1.
Limit (limit)	Number	The maximum number of people to be returned per page.
Order by (order)	Options List	Field by which the results will be ordered. Options: created_at, updated_at, name.
Sort Direction	Options List	Defines the sort direction. Options: asc (ascending) or desc (descending).
Start Date	Date/Time	Returns people created from this date and time onward.
End Date	Date/Time	Returns people created up to this date and time.
Full name	Text	Filters people by a specific name.
Email	Text	Filters people by a specific email address.
Phone	Text	Filters people by a specific phone number.
Search (search)	Text	Performs a general search for a term across several of the person's main fields.
Full Search	Boolean	If true, performs a deeper and more comprehensive search, which may take longer.
Has Duplicate Keys	Boolean	If true, returns only people who have duplicate identifiers (e.g., same email).
Is Blocked	Boolean	Filters people by their blocked status (true for blocked, false for not blocked).
Organization	Options List	Filters people who belong to a specific organization.
Custom Fields	Key-Value	Filters people based on the values of their custom fields.

---

Output Structure (Example Result)

The output of this block will be an object containing the list of people and pagination information.

JSON

{
  "data": [
    {
      "id": "person_abcdef123456",
      "name": "Juliana Souza",
      "customer_status": "customer",
      "created_at": "2024-08-16T15:30:00Z",
      "emails": [{"email": "[email protected]"}]
    },
    {
      "id": "person_ghijkl789012",
      "name": "Marcos Almeida",
      "customer_status": "lead",
      "created_at": "2024-08-15T11:20:00Z",
      "emails": [{"email": "[email protected]"}]
    }
  ],
  "pagination": {
    "total": 527,
    "page": 1,
    "limit": 2
  }
}

---

🚀 Example Use Case

Goal: Generate a weekly report with all new qualified leads and send it to a Google Sheets spreadsheet.

1. Create a flow with a scheduled trigger to run every Monday at 9 AM.

2. Add the "People" block with the "Get All" operation.

3. Configure the following filters:

   • Start Date: Use an expression to set the date to 7 days ago.

   • End Date: Use an expression for the current date.

   • Customer Status: Select sales_qualified_lead.

4. Add a loop (loop) to iterate over the list of people returned ({{steps.2.result.data}}).

5. Inside the loop, add a Google Sheets block with the "Add Row" action and map each person's data (name, email, phone, etc.) to the columns of your spreadsheet.

With this flow, your sales team will receive an updated list of qualified leads at the start of each week, completely automatically.