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

# Gong List Flows: Inputs, Cost & CLI Example

> List Gong Engage flows (/v2/flows). Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_list_flows:{"flowOwnerEmail":"{{flowOwnerEmail}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                           | Type      | Required | Default | Description                                                                                                        |
| ------------------------------ | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
| `payload.flowOwnerEmail`       | `string`  | Yes      |         | Email of the Gong user whose personal flows and flows shared with the user you want to return.                     |
| `payload.cursor`               | `string`  | No       |         | When paging is needed, provide the value supplied by the previous API call to bring the following page of records. |
| `payload.workspaceId`          | `string`  | No       |         | Optional Workspace identifier, if supplied the API will return only the flows belonging to this workspace.         |
| `payload.folderId`             | `string`  | No       |         | Optional Folder identifier, if supplied the API will return only the flows belonging to this particular folder.    |
| `payload.mostRecentlyAssigned` | `boolean` | No       |         | Optional flag, if supplied the API will return only the most recently assigned flows capped at 20.                 |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Engage flows have the following visibility types: * Company: visible to everyone in the company, can only be edited by users with edit permissions. * Personal: reps can set up their own flows which are only available to them. * Shared: reps can share a flow with other reps. Those reps can then add leads to the flow. This endpoint returns all company flows, together with personal flows and flows shared with the user specified in the flowEmailOwner parameter. Alternatively this endpoint can return the flows most recently assigned by the user. When accessed through a Bearer token authorization method, use the 'api:flows:read' scope.",
    "properties": {
      "flowOwnerEmail": {
        "type": "string",
        "description": "Email of the Gong user whose personal flows and flows shared with the user you want to return."
      },
      "cursor": {
        "type": "string",
        "description": "When paging is needed, provide the value supplied by the previous API call to bring the following page of records."
      },
      "workspaceId": {
        "type": "string",
        "description": "Optional Workspace identifier, if supplied the API will return only the flows belonging to this workspace."
      },
      "folderId": {
        "type": "string",
        "description": "Optional Folder identifier, if supplied the API will return only the flows belonging to this particular folder."
      },
      "mostRecentlyAssigned": {
        "type": "boolean",
        "description": "Optional flag, if supplied the API will return only the most recently assigned flows capped at 20."
      }
    },
    "required": [
      "flowOwnerEmail"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "requestId": {
            "type": "string",
            "description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
          },
          "records": {
            "type": "object",
            "description": "Information about the number of records that match the requested filter.",
            "properties": {
              "totalRecords": {
                "type": "integer",
                "description": "Total number of records.",
                "format": "int32"
              },
              "currentPageSize": {
                "type": "integer",
                "description": "Number of records in the current page.",
                "format": "int32"
              },
              "currentPageNumber": {
                "type": "integer",
                "description": "Current page number.",
                "format": "int32"
              },
              "cursor": {
                "type": "string",
                "description": "Returned only when there are more records to be retrieved. Repeat the API call and pass this cursor value in the request to retrieve the next page of records."
              }
            },
            "additionalProperties": false
          },
          "flows": {
            "type": "array",
            "description": "A list, in which each item specifies one Flow.",
            "items": {
              "type": "object",
              "description": "A list, in which each item specifies one Flow.",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The id of the flow"
                },
                "name": {
                  "type": "string",
                  "description": "The name of the flow"
                },
                "folderId": {
                  "type": "string",
                  "description": "The id of the folder this flow is under"
                },
                "folderName": {
                  "type": "string",
                  "description": "The name of the folder this flow is under"
                },
                "visibility": {
                  "type": "string",
                  "description": "The flow visibility type",
                  "enum": [
                    "Company",
                    "Personal",
                    "Shared"
                  ]
                },
                "creationDate": {
                  "type": "string",
                  "description": "Creation time of the flow in ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC)."
                },
                "exclusive": {
                  "type": "boolean",
                  "description": "indicates whether a prospect in this flow can be added to other flows"
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute gong_list_flows --payload '{
  "flowOwnerEmail": "string"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.
