---
title: "Retrieve email campaigns for automation flows."
method: GET
path: "/automation/2026-09-beta/flows/email-campaigns"
tags: ["Basic"]
---

# Retrieve email campaigns for automation flows.

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/automation/2026-09-beta/flows/email-campaigns`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `automation`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.delete`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `workflows.read`

Retrieve a list of email campaigns associated with automation flows. This endpoint allows you to filter and paginate through email campaigns using various query parameters. It is useful for obtaining detailed information about email campaigns linked to specific flows.

## Query parameters

- `after` string
- `before` string
- `flowId` string[]
- `limit` integer

## Response `200`

successful operation

- CollectionResponseApiFlowEmailCampaign
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `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.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A paging cursor token for retrieving previous pages.
      - `link` string: A URL that can be used to retrieve the previous pages' results.
  - `results` ApiFlowEmailCampaign[], required
    - `emailCampaignId` string, required: The unique identifier for the email campaign associated with the automation flow.
    - `emailContentId` string, required: The unique identifier for the email content used in the email campaign.
    - `flowId` string, required: The unique identifier for the automation flow associated with the email campaign.

## Other responses

- `default`: An error occurred.

## Changes

> 98 revisions in range; 5 not diffed.

- **2026-11-13** (2026-09-beta) `6ee0f25fe1ee`: 2 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `workflows.read` was removed from the endpoint's security scheme `oauth2`
- **2026-07-13** (2026-09-beta) `437ab7f7961c`: 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `614f5ff8daff`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (2026-09-beta) `c0e43a548369`: 3 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `workflows-access` was removed from the endpoint's security scheme `oauth2`
  - the security scope `workflows-access-public-api` was removed from the endpoint's security scheme `oauth2`
- **2026-04-21** (2026-09-beta) `6cc579e23fb8`: 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/automation-automation-v4/changes/automation/2026-09-beta/flows/email-campaigns/get.md)

---

[API](https://skmtc.dev/hubspot/apis/automation-automation-v4.md) - [All operations](https://skmtc.dev/hubspot/apis/automation-automation-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/automation-automation-v4/revisions/6ee0f25fe1ee?raw)