Create a feed

Create a feed your platform can push products into, or that we pull from a URL you host. This is the entry point for a merchant who is not on Shopify or WooCommerce.

By default the response also mints the HMAC signing secret for POST /feeds/{id}/events. That secret is returned exactly once. Store it before you close the response; rotating is the only way to get another.

Authorization

AuthorizationBearer <token>

API key in the Authorization header: Authorization: Bearer ace_live_.... Use an ace_test_... key for the free, rate-capped sandbox.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

projectId?string

Required for an account-wide key.

name*string

Display name, unique within the project.

Lengthlength <= 200

source?string

url polls a file you host on a schedule; api waits for signed delta pushes. A feed can do both.

Default"api"

Value in

"url"
"api"

sourceUrl?string

Required when source is url. Must be publicly reachable; private and internal addresses are rejected.

refreshCron?string

Standard cron. Runs no more often than every 30 minutes.

refreshTimezone?string

Default"UTC"

createIngestSecret?boolean

Defaulttrue

refreshNow?boolean

Pull the URL immediately rather than waiting for the schedule.

Defaultfalse

Response Body

`application/json`

curl -X POST "https://example.com/feeds" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "data": {    "feedId": "string",    "projectId": "string",    "name": "string",    "source": "string",    "eventsUrl": "string",    "ingestSecret": "string",    "sourceError": "string"  }}

{  "error": {    "code": "INSUFFICIENT_CREDITS",    "message": "Not enough credits for this request.",    "details": null  }}

{  "error": {    "code": "INSUFFICIENT_CREDITS",    "message": "Not enough credits for this request.",    "details": null  }}

{  "error": {    "code": "PROJECT_SCOPE_MISMATCH",    "message": "This API key is scoped to a different project."  }}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`