Updates the specified note by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Bulk updates to a product catalog can also be performed via API. To do so, the Body Type of the call must be set to raw and the Content Type must be set to application/json. A JSON file can then be placed in the body of the call—the parameters found in this file (see the example below) will be used to update each item. The item's CatalogItemId must be used in each object within the JSON file so that the correct items are updated.

Example bulk update:
[{"CatalogItemId":"ABC-123456", "Name":"Particle Collider", "Url":"https://www.example.com", "CurrentPrice":"12.00"},{"CatalogItemId":"ABC-45678", "Name":"Particle Collider1", "Url":"https://www.example.com", "CurrentPrice":"13.00"}].

Please note that impact.com allows a maximum of 500 products per update.

Single product update allows you to update a catalog item. The supported submission formats are Form and JSON formats. The Body Type of the call must be set to either form-data, raw, or x-www-form-urlencoded and enter key-value pairs as the data you wish to send.

Example single update:
{"CatalogItemId":"ABC-123456", "Name":"Particle Collider", "Url":"

For both single and bulk updates, field names and field values must be in double quotes.

Parameters

Adult optional

The item is only intended for adults.

AgeGroup optional

Age group that the item targets.

Category optional

What group or kind of products the item is associated with.

Colors optional

Comma-separated list of the primary color(s) of the item.

Condition optional

What condition the item is in when it is sold.

Currency optional

What currency the item's price is listed in. See ISO 4217.

Description optional

Description of the item, like information about it or what it does.

ImageUrl optional

URL that leads to the item's image.

PromotionIds optional

List of promotion Ids that identify an item as part of a promotion. Can add multiple promotion Ids. Use commas between each new promotion Id.

Inventory optional

Inventory count of the item.

Labels optional

Key terms to help partners find a particular catalog in impact.com. Can add multiple labels. Use commas between each new label.

LaunchDate optional

Date the item becomes available (or became available if already released). See ISO 8601.

Manufacturer optional

The person or group that makes the item.

Material optional

Comma-separated list of the primary material(s) of the item.

Name optional

Name of the item.

OriginalPrice optional

Original price of the item.

Pattern optional

Pattern of the item.

ProductBid optional

How much the partner will be paid for driving a conversion on the product.

ShippingHeight optional

Height of the shipping parcel.

ShippingLabel optional

Label of the shipping parcel.

ShippingLength optional

Length of the shipping parcel.

ShippingLengthUnit optional

Measurement unit of the length of the shipping parcel.

ShippingRate optional

How much shipping the item costs.

ShippingWeight optional

Weight of the shipping parcel.

ShippingWeightUnit optional

Measurement of the weight of the shipping parcel.

ShippingWidth optional

Width of the shipping parcel.

StockAvailability optional

Status of the product's backstock.

Url optional

URL that leads to the item's online store listing.

More parameters

Returns

Returns the status of the request and the URI of the newly updated note. Returns an error if update parameters are invalid.

curl 'https://api.impact.com/Advertisers/<AccountSID>/Catalogs/4000/Items/55555' \
  -X PUT \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -d 'Adult=false' \
  -d 'Name=Hammer' \
  -d 'StockAvailability="BackOrder"' \
  -d 'Gtin=14141414141414'

curl 'https://api.impact.com/Advertisers/<AccountSID>/Catalogs/4000/Items' \
  -X PUT \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '[{"CatalogItemId:"12345", "Name":"Anvil"}, {"CatalogitemId":"67890", "CurrentPrice":"50.00"}]'

{
  "Status": "OK",
  "Uri": "/Advertisers/<AccoutnSID>/Catalogs/4000/Items/55555"
}

{
  "Status": "OK",
  "Uri": "/Advertisers/<AccountSID>/Catalogs/4000/BulkUpdate/Products updated successfully.json"
}