Skip to main content
PATCH
/
catalog
/
{catalog_id}
/
items
Update Existing Items in a Catalog
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
      }
    }
  ]
}
'
{
  "message": {
    "valid": {
      "count": 1
    },
    "invalid": {
      "count": 8,
      "details": [
        {
          "error-id": "item-not-found",
          "message": "Item with id %s not found in the catalog. Please check the item id and try again.",
          "count": 1,
          "document_ids": [
            "567890"
          ]
        },
        {
          "error-id": "invalid-attributes",
          "message": "Some of the attributes are not defined in the catalog schema: (shipping_city)",
          "count": 2,
          "document_ids": [
            "312",
            "8291379"
          ]
        }
      ]
    }
  }
}

​
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

​
Authorization
string
header
required

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

​
MOE-APPKEY
string
required

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

​
catalog_id
string
required

The unique identifier for the catalog, obtained during catalog creation.

Body

application/json
​
items
object[]
required

An array of item updates. Each object must contain the item id and the attributes to update.

Maximum array length: 50

Response

OK. The update request was processed. The response body contains details on valid and invalid item counts.

​
message
object