---
title: "Retrieve a list of automation flows."
method: GET
path: "/automation/2026-09-beta/flows"
tags: ["Basic"]
---

# Retrieve a list of automation flows.

`GET /automation/2026-09-beta/flows`

Retrieve a list of automation flows available in your HubSpot account. This endpoint supports pagination to navigate through large sets of flows, allowing you to specify the number of results per page and to continue from a specific point in the list using a cursor token.

## Query parameters

- `after` string
- `limit` integer

## Response `200`

successful operation

- CollectionResponseApiFlowListingForwardPaging
  - `paging` ForwardPaging
    - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required — A paging cursor token for retrieving subsequent pages.
      - `link` string — A URL that can be used to retrieve the next page results.
  - `results` ApiFlowListing[], required
    - `createdAt` string, date-time, required — The date and time when the automation flow was created, formatted as a date-time string.
    - `flowType` 'ACTION_SET' | 'UNKNOWN' | 'WORKFLOW', required — Specifies the type of the automation flow (PLATFORM vs. CONTACT)
    - `id` string, required — The unique identifier for the automation flow.
    - `isEnabled` boolean, required — Indicates whether the automation flow is currently active.
    - `name` string — The name assigned to the automation flow.
    - `objectTypeId` string, required — Represents the ID of the object type associated with the automation flow.
    - `revisionId` string, required — The identifier for the current revision of the automation flow.
    - `updatedAt` string, date-time, required — The date and time when the automation flow was last updated, formatted as a date-time string.
    - `uuid` string — The universally unique identifier for the automation flow.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/automation-automation-v4.md) · [All operations](https://skmtc.net/hubspot/apis/automation-automation-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/automation-automation-v4/revisions/2b1538611adf/schema)