Product feeds

Schedule product upload from file

Creates a product feed: Meta periodically downloads a product file from a URL and processes it on the schedule you set.

• With schedule, the file replaces the catalog's contents: products in the file are created or updated, and products missing from it are deleted.
• With update_schedule, products in the file are only created or updated.
• With override_type, the file contains localized information (language, country, or both) for products that already exist in the catalog.

Request

Schedule product upload from file request:

Headers

Schedule product upload from file headers:

Parameters

Schedule product upload from file parameters:

Body

Schedule product upload from file body fields:

Schedule object

Used in both schedule and update_schedule.

Example

Complete Schedule product upload from file example:

Replace the catalog's contents once a day:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Products_daily_replace",
    "schedule": {
        "interval": "DAILY",
        "url": "https://www.example.com/feeds/products.csv",
        "hour": "13",
        "minute": "5",
        "timezone": "America/Mexico_City"
    }
}'

Create or update products every hour:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Products_hourly_update",
    "update_schedule": {
        "interval": "HOURLY",
        "url": "https://www.example.com/feeds/products-updates.csv",
        "minute": "10",
        "timezone": "America/Mexico_City"
    }
}'

Load localized information by language and country:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/product_feeds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{admin-token}}' \
--data '{
    "name": "Products_localized_daily",
    "override_type": "language_and_country",
    "schedule": {
        "interval": "DAILY",
        "url": "https://www.example.com/feeds/products-localized.csv",
        "hour": "14",
        "timezone": "America/Mexico_City"
    }
}'

Response

Schedule product upload from file response:

💾
{
    "id": "987654321098765"
}

List product feed uploads

Returns the uploads (upload sessions) of a product feed, sorted by start time.

Request

List product feed uploads request:

Headers

List product feed uploads headers:

Parameters

List product feed uploads parameters:

Example

Complete List product feed uploads example:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/uploads' \
--header 'Authorization: Bearer {{admin-token}}'

Response

List product feed uploads response:

The service returns a list of uploads.

💾
[
    {
        "id": "112233445566778",
        "startTime": "2026-11-02T18:53:25+0000",
        "endTime": "2026-11-02T19:00:34+0000"
    },
    {
        "id": "112233445566779",
        "startTime": "2026-11-03T18:50:48+0000",
        "endTime": "2026-11-03T19:00:24+0000"
    }
]

Get upload errors

Returns the errors Meta found while processing a product feed upload.

Request

Get upload errors request:

Headers

Get upload errors headers:

Parameters

Get upload errors parameters:

Example

Complete Get upload errors example:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/errors' \
--header 'Authorization: Bearer {{admin-token}}'

Response

Get upload errors response:

Upload error object

Samples object

Sample object

Paging object

💾
{
    "data": [
        {
            "id": "556677889900112",
            "summary": "Missing price",
            "description": "Add a price to your products.",
            "severity": "fatal",
            "affected_surfaces": [
                "Dynamic Ads",
                "Shops"
            ],
            "samples": {
                "data": [
                    {
                        "id": "556677889900113",
                        "row_number": 3,
                        "retailer_id": "ENGLISH_COURSE_004"
                    }
                ]
            }
        }
    ],
    "paging": {
        "cursors": {
            "before": "QVFIUjExampleBefore",
            "after": "QVFIUjExampleAfter"
        }
    }
}

Request error report

Asks Meta to generate a file with an upload's errors. When it's ready, download it with the Download error report service.

Request

Request error report request:

Headers

Request error report headers:

Parameters

Request error report parameters:

Example

Complete Request error report example:

💾
curl --location --request POST 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/error_report' \
--header 'Authorization: Bearer {{admin-token}}'

Response

Request error report response:

💾
{
    "success": true
}

Download error report

Returns the status of an upload's error report and, once it's generated, the URL to download it.

Request

Download error report request:

Headers

Download error report headers:

Parameters

Download error report parameters:

Example

Complete Download error report example:

💾
curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/catalog/{{waba_id}}/{{catalog_id}}/{{product_feed_id}}/{{upload_session_id}}/errors/download' \
--header 'Authorization: Bearer {{admin-token}}'

Response

Download error report response:

Error report object

Report ready:

💾
{
    "id": "112233445566778",
    "errorReport": {
        "reportStatus": "WRITE_FINISHED",
        "fileHandle": "https://www.example.com/reports/upload-errors-112233445566778.csv"
    }
}

Report not requested:

💾
{
    "id": "112233445566779",
    "errorReport": {
        "reportStatus": "NOT_REQUESTED"
    }
}