Create a Collection
Token-authenticated; requires storefront.update (or legacy
collections.update during the migration).
Triggers fresh Lighthouse + compliance scans automatically
— a subsequent GET :id/lighthouse / :id/compliance
returns scan_status: pending while the queued scans run.
curl --request POST \
--url https://api.fluid.app/api/v202604/company/collections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"collection": {
"title": "Wellness Essentials"
}
}
'{
"status": 201,
"meta": {
"request_id": "c4a1e2f7-3b9d-4e58-a0c6-7d2f91b84e13",
"timestamp": "2026-09-14T15:42:08Z"
},
"collection": {
"id": 5224,
"slug": "schrute-farms-picks",
"title": "Schrute Farms Picks",
"description": "Beets, beet products, and beet-adjacent merchandise from Schrute Farms.",
"image_url": "https://ik.imagekit.io/fluidapp/dunder-mifflin/collections/schrute-farms-picks.png",
"canonical_url": "https://shop.dundermifflin.com/home/collections/schrute-farms-picks",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-14T15:42:07Z",
"updated_at": "2026-09-14T15:42:07Z",
"seo": {
"title": "Schrute Farms Picks",
"description": "Beets, beet products, and beet-adjacent merchandise from Schrute Farms.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/collections/schrute-farms-picks.png",
"indexable": true,
"id": 16241
},
"metafields": [
{
"namespace": "custom",
"key": "theme_accent",
"value": "#8E2C48",
"value_type": "single_line_text_field",
"description": null,
"created_at": "2026-09-14T15:42:07Z",
"updated_at": "2026-09-14T15:42:07Z",
"locked": false
}
],
"languages": [
"en"
],
"countries": [],
"custom_slug": true
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}Authorizations
Bearer token authentication. Accepts company-admin tokens with
storefront.view for read operations and storefront.update
for writes and scan triggers (legacy per-resource grants like
categories.update / products.view / etc. are still accepted
during the migration), required on every company operation.
Storefront public operations under /api/v202604/{resource} and
/api/v202604/{resource}/{slug} are unauthenticated
(security: []).
Query Parameters
Response locale. ISO code (e.g. fr, de). When omitted,
responds in the company's default locale. On reads an
unsupported or unknown locale is ignored — the response comes
back in the default locale, never a 422. Any translated field
with no value in the requested locale falls back to its en
value.
"fr"
Body
Show child attributes
Show child attributes
Response
The created Collection.
Shared success envelope for list / show / create / update
responses: the resource payload is returned alongside a top-level
integer status and meta. Composed onto each resource response
via allOf.
200
Response metadata included on every successful response body.
request_id and timestamp are always present; list endpoints
also add pagination.
Show child attributes
Show child attributes
Authenticated (company-surface) Collection read shape: the public
CollectionBase plus custom_slug, admin metadata never rendered on
the public surface.
Show child attributes
Show child attributes
curl --request POST \
--url https://api.fluid.app/api/v202604/company/collections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"collection": {
"title": "Wellness Essentials"
}
}
'{
"status": 201,
"meta": {
"request_id": "c4a1e2f7-3b9d-4e58-a0c6-7d2f91b84e13",
"timestamp": "2026-09-14T15:42:08Z"
},
"collection": {
"id": 5224,
"slug": "schrute-farms-picks",
"title": "Schrute Farms Picks",
"description": "Beets, beet products, and beet-adjacent merchandise from Schrute Farms.",
"image_url": "https://ik.imagekit.io/fluidapp/dunder-mifflin/collections/schrute-farms-picks.png",
"canonical_url": "https://shop.dundermifflin.com/home/collections/schrute-farms-picks",
"images": {
"thumb": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-200,c-at_max,f-auto,q-70/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 200
},
"medium": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 600
},
"large": {
"url": "https://ik.imagekit.io/fluidapp/tr:w-1200,c-at_max,f-auto,q-80/dunder-mifflin/collections/schrute-farms-picks.png",
"width": 1200
}
},
"active": true,
"status": "published",
"publish_at": null,
"created_at": "2026-09-14T15:42:07Z",
"updated_at": "2026-09-14T15:42:07Z",
"seo": {
"title": "Schrute Farms Picks",
"description": "Beets, beet products, and beet-adjacent merchandise from Schrute Farms.",
"image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/dunder-mifflin/collections/schrute-farms-picks.png",
"indexable": true,
"id": 16241
},
"metafields": [
{
"namespace": "custom",
"key": "theme_accent",
"value": "#8E2C48",
"value_type": "single_line_text_field",
"description": null,
"created_at": "2026-09-14T15:42:07Z",
"updated_at": "2026-09-14T15:42:07Z",
"locked": false
}
],
"languages": [
"en"
],
"countries": [],
"custom_slug": true
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"pagination": {
"cursor": "<string>",
"limit": 25,
"prev_cursor": "<string>",
"next_cursor": "<string>"
}
}
}