# Return a user's homepage feed

Provides a user’s homepage feed, complete with the homepage banner, user’s shortcuts and modules.
 This is a restricted endpoint that requires enablement. Reach out to your Firstup representative for access.

Endpoint: GET /v2/feeds/web_homepage
Version: 2026-05-01
Security: oauth2_as_a_user

## Security:

  - `oauth2_as_a_user` (unknown)
    oauth2 scopes: feeds.read

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `data` (object, required)
    A user's assembled custom homepage. The `feed` array contains an ordered list of modules. Each module has a `type` and an `attributes` object whose shape depends on the module type (`banner`, `link_carousel`, or a content module: `hero`, `grid`, `gallery`, `row`). Content modules embed their resolved `feed_items`.
    Example: {"type":"web_homepage","attributes":{"id":"1f2e3d4c-5b6a-7980-1234-567890abcdef","feed":[{"type":"banner","attributes":{"id":"11111111-1111-1111-1111-111111111111","size":"large","web_image":"https://…

  - `data.type` (string, required)
    Example: web_homepage

  - `data.attributes` (object, required)

  - `data.attributes.id` (string, required)
    Unique identifier for the homepage selected for this user.
    Example: 1f2e3d4c-5b6a-7980-1234-567890abcdef

  - `data.attributes.feed` (array, required)
    Ordered list of homepage modules.

  - `data.attributes.feed.type` (string, required)
    The module type.
    Enum: "banner", "link_carousel", "hero", "grid", "gallery", "row"

  - `data.attributes.feed.attributes` (object, required)
    Module attributes; shape depends on `type`.

## Response 400:

  - `400` (unknown)
    Bad Request. See more on  error responses here .

## Response 401:

  - `401` (unknown)
    Unauthenticated. See more on  error responses here.