Update a catalog

This endpoint programmatically updates a catalog's Pull from URL settings, which automates your workflow and removes the need for manual UI configuration.

Parameters

---

uploadType required

A string that contains the ingestion method. For this configuration the value must be set to CLIENT_PULL.

---

pullFromURLSettings required

An object that contains the configuration for how the catalog synchronizes product data from a remote file.

---

address required

A string that specifies the full URL or path of the remote product feed file (e.g., ftp://user:[[email protected]]([email protected])/feed.csv).

---

fileName required

A string that specifies the name of the file to be processed from the remote server.

---

pullFrequency required

A string that determines how often the feed should be pulled. Allowed values are 2H, 4H, 8H, 1W (weekly), and 1M (monthly).

---

pullTime optional

A string specifying the scheduled time for the pull to occur (e.g., 12:30). See ISO-8601.

---

timeZone optional

A string representing the timezone for the scheduled pull (e.g., America/New_York).

Returns

---

A successful request returns the full catalog object with the updated fields. The example below shows the cURL request and the corresponding JSON object that is returned.

Example Request

---

cURL

curl 'https://api.impact.com/Advertisers/<AccountSID>/Catalogs/55555' \
  -X PUT \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  	"uploadType": "CLIENT_PULL",
  	"pullFromUrlSettings": {
    		"address": "ftp://[username]:[password]@ftp.example.com/feed.txt",
    		"fileName": "feed.txt",
    		"pullFrequency": "H8",
    		"pullTime": "12:30",
    		"timeZone": "America/New_York"
  	}
}'

Example Response

---

JSON

{
    "Id": "55555",
    "Name": "Summer Catalog",
    "Language": "en",
    "Currency": "USD",
    "CreatedDate": "2026-01-15T10:30:00Z",
    "LastModified": "2026-02-13T11:00:00Z",
    "uploadType": "CLIENT_PULL",
    "pullFromUrlSettings": {
        "address": "ftp://acme-user:[email protected]/feed.txt",
        "fileName": "feed.txt",
        "pullFrequency": "H8",
        "pullTime": "12:30",
        "timeZone": "America/New_York",
        "LastPullStatus": "PENDING"
    }
}