---
title: "POST /list-flows"
method: POST
path: "/list-flows"
---

# POST /list-flows

`POST /list-flows`

Lists all of the flows associated with your account.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `maxResults` integer — Specifies the maximum number of items that should be returned in the result set.
  - `nextToken` string — The pagination token for next page of data.

## Response `200`

Success

- ListFlowsResponse
  - `flows` FlowDefinition[] — The list of flows associated with your account.
    - `flowArn` string — The flow's Amazon Resource Name (ARN).
    - `description` string — A user-entered description of the flow.
    - `flowName` string — The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.
    - `flowStatus` 'Active' | 'Deprecated' | 'Deleted' | 'Draft' | 'Errored' | 'Suspended' — Indicates the current status of the flow.
    - `sourceConnectorType` 'Salesforce' | 'Singular' | 'Slack' | 'Redshift' | 'S3' | 'Marketo' | 'Googleanalytics' | 'Zendesk' | 'Servicenow' | 'Datadog' | 'Trendmicro' | 'Snowflake' | 'Dynatrace' | 'Infornexus' | 'Amplitude' | 'Veeva' | 'EventBridge' | 'LookoutMetrics' | 'Upsolver' | 'Honeycode' | 'CustomerProfiles' | 'SAPOData' | 'CustomConnector' | 'Pardot' — Specifies the source connector type, such as Salesforce, Amazon S3, Amplitude, and so on.
    - `sourceConnectorLabel` string — The label of the source connector in the flow.
    - `destinationConnectorType` 'Salesforce' | 'Singular' | 'Slack' | 'Redshift' | 'S3' | 'Marketo' | 'Googleanalytics' | 'Zendesk' | 'Servicenow' | 'Datadog' | 'Trendmicro' | 'Snowflake' | 'Dynatrace' | 'Infornexus' | 'Amplitude' | 'Veeva' | 'EventBridge' | 'LookoutMetrics' | 'Upsolver' | 'Honeycode' | 'CustomerProfiles' | 'SAPOData' | 'CustomConnector' | 'Pardot' — Specifies the destination connector type, such as Salesforce, Amazon S3, Amplitude, and so on.
    - `destinationConnectorLabel` string — The label of the destination connector in the flow.
    - `triggerType` 'Scheduled' | 'Event' | 'OnDemand' — Specifies the type of flow trigger. This can be <code>OnDemand</code>, <code>Scheduled</code>, or <code>Event</code>.
    - `createdAt` string, date-time — Specifies when the flow was created.
    - `lastUpdatedAt` string, date-time — Specifies when the flow was last updated.
    - `createdBy` string — The ARN of the user who created the flow.
    - `lastUpdatedBy` string — Specifies the account user name that most recently updated the flow.
    - `tags` object — The tags used to organize, track, or control access for your flow.
    - `lastRunExecutionDetails` object — Describes the details of the most recent flow run.
      - `mostRecentExecutionMessage` string — Describes the details of the most recent flow run.
      - `mostRecentExecutionTime` string, date-time — Specifies the time of the most recent flow run.
      - `mostRecentExecutionStatus` 'InProgress' | 'Successful' | 'Error' — Specifies the status of the most recent flow run.
  - `nextToken` string — The pagination token for next page of data.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException

---

[API](https://skmtc.net/aws/apis/appflow.md) · [All operations](https://skmtc.net/aws/apis/appflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/appflow/versions/a56dde8bf1e0/schema)