Authenticate with a bearer token scoped for catalog write operations via your Connect OAuth application
Identify items whose availability has changed in your inventory system (e.g., out-of-stock, discontinued, back-in-stock) since the last sync
Construct catalog update payloads using the retailer item ID, the updated availability status, and optionally updated price data
Batch catalog updates within the limits supported by the API to minimize round-trips; avoid sending per-item requests for large assortments
POST the catalog update to the appropriate catalog availability endpoint; log the API response to confirm which item updates were accepted or rejected
Schedule incremental syncs on a cadence appropriate for your inventory system's change frequency; trigger immediate updates for high-velocity stock events like flash sales
Known gotchas
Catalog updates are eventually consistent — there may be a delay before availability changes are reflected to shoppers on Instacart; do not expect real-time propagation for all use cases
Item IDs in the catalog must match the IDs used at order creation; mismatched identifiers will result in catalog updates that do not map to orderable items
Bulk catalog operations may have rate limits and batch size constraints documented in the API reference — test batch sizes in sandbox before running production catalog loads
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp