---
title: "Ingest feed items"
method: POST
path: "/catalogs/feeds/{feed_id}/ingest"
tags: ["catalog_feeds"]
---

# Ingest feed items

`POST /catalogs/feeds/{feed_id}/ingest`

Ingest items for a given feed owned by the "operation user_account".

Optional: Business Access: Specify an `ad_account_id` (obtained via [List ad accounts](/docs/api/v5/#operation/ad_accounts/list)) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following [Business Access](https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts) roles on the ad_account: Owner, Admin, Catalogs Manager.

[Learn more](/docs/api-features/shopping-overview/)

Note: This endpoint is restricted to a specific group of users. If you require access, please reach out to your partner manager.

## Path parameters

- `feed_id` string, required

## Query parameters

- `ad_account_id` string

## Response `200`

The request has succeeded.

- CatalogsFeedIngestion
  - `created_at` string, date-time, required — Timestamp of the feed ingestion.
  - `feed_id` string, required — Catalog Feed id pertaining to the feed ingestion.
  - `id` string, required — Unique identifier of a feed ingestion.
  - `status` 'COMPLETED' | 'FAILED' | 'PROCESSING', required

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 8 info
  - the `status` response's property type changed from `string` to no type for status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - added `#/components/schemas/CatalogsFeedProcessingStatus` to the `status` response property `allOf` list for the response status `200`
  - …5 more
- **2025-04-04** (v5) `10f9eba4ad97` — 2 info
  - api tag `catalog_feeds` added
  - api tag `catalogs` removed
- **2024-08-14** (v5) `89c27ed39cfd` — 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`
- **2024-04-23** (v5) `f9321315766f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/catalogs/feeds/:feed_id/ingest/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/b698c180678a?raw)