Create Report Request

POST 
/api/walmart/:integrationInstance/reports/requests

Create an on-request report request. Walmart generates the report asynchronously; poll its status with Get Report Request Status and fetch the file with Get Report Download URL once it is READY.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Fields:

• report_type (string, required): the type of report to generate, e.g. ITEM.
• report_version (string, optional): the report version; defaults to v1.

Authentication: Requires Bearer token.

Requires the integrations.sync permission.

Request

Responses

201

Created

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden

Response Headers

Content-Type

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Unprocessable Entity

Response Headers

Content-Type

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.