Add a feed
Adds a feed as a product source of the store, after the store’s other sources, and imports it right away. 422 `feed_mapping_incomplete` when the mapping lacks what the settings need.
POST
Adds a feed as a product source of the store, after the store’s other sources, and imports it right away. 422 feed_mapping_incomplete when the mapping lacks what the settings need.
apiKey writeheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
Length
1 <= length <= 255application/json- body
name*stringLength
1 <= length <= 100url*stringWhere the file is: a public http(s) URL
Format
uriLength
length <= 2000locale*|Every row’s locale; null when a column is mapped to locale
Length
length <= 35mode*stringValue in
"add_and_enrich""enrich_only"mapping*Column name → a field, ignore, or { "custom": "<key>" }
storeId*stringFormat
uuidOK
application/json- response
id*stringFormat
uuidstore*name*stringurl*stringFormat
urilocale*string|nullmode*stringValue in
"add_and_enrich""enrich_only"mapping*Column name → a field, ignore, or { "custom": "<key>" }
rank*integerlatestImport*|nullnextImportAt*stringFormat
date-timecreatedAt*stringFormat
date-timecurl -X POST 'https://api.postforge.dev/v1/feeds' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "url": "http://example.com", "locale": "string", "mode": "add_and_enrich", "mapping": { "property1": "id", "property2": "id" }, "storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "store": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "platform": "string" }, "name": "string", "url": "http://example.com", "locale": "string", "mode": "add_and_enrich", "mapping": { "property1": "id", "property2": "id" }, "rank": 0, "latestImport": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "feedId": "30c3a808-1315-453b-94cf-0ccb129b558b", "status": "queued", "trigger": "created", "format": "csv", "bytes": 0, "counts": { "rows": 0, "imported": 0, "variantOnly": 0, "fromFirstRow": 0, "created": 0, "products": 0, "unmatched": 0, "skipped": 0, "removed": 0 }, "error": "unreachable", "queuedAt": "2019-08-24T14:15:22Z", "startedAt": "2019-08-24T14:15:22Z", "completedAt": "2019-08-24T14:15:22Z" }, "nextImportAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z"}