curl --request PATCH \
--url https://api-{dc}.moengage.com/v1/catalog/{catalog_id}/items \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'MOE-APPKEY: <moe-appkey>' \
--data '
{
"items": [
{
"id": "Existing_item_ID",
"attributes": {
"attribute_name": "updated_value"
}
},
{
"id": "test2",
"attributes": {
"price": 98,
"sale_start_date": "2025-08-27T19:26:38.00Z",
"store_location": "12.9716,77.5946"
}
}
]
}
'Update Items
This API updates items with new attribute values. Attributes must adhere to the data type defined.
curl --request PATCH \
--url https://api-{dc}.moengage.com/v1/catalog/{catalog_id}/items \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'MOE-APPKEY: <moe-appkey>' \
--data '
{
"items": [
{
"id": "Existing_item_ID",
"attributes": {
"attribute_name": "updated_value"
}
},
{
"id": "test2",
"attributes": {
"price": 98,
"sale_start_date": "2025-08-27T19:26:38.00Z",
"store_location": "12.9716,77.5946"
}
}
]
}
'Rate Limit
- Request limit: You can update 100 items per minute OR 1000 items per hour. You can update up to 50 items per request.
- Payload size limit: 5 MB only when Content-Length header is provided.
Authorizations
Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.
- Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
- Password: Use your API Key, which you can find within the Campaign report/Business events/Custom templates/Catalog API/Inform Report tile.
For more information on authentication and getting your credentials, refer here.
Headers
This is the Workspace ID of your MoEngage account that must be passed with the request. You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
Path Parameters
The unique identifier for the catalog, obtained during catalog creation.
Body
An array of item updates. Each object must contain the item id and the attributes to update.
50Show child attributes
Show child attributes
Response
OK. The update request was processed. The response body contains details on valid and invalid item counts.
Show child attributes
Show child attributes