Create a Post

POST

api

v202604

company

posts

curl --request POST \
  --url https://api.fluid.app/api/v202604/company/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "post": {
    "title": "How We Shipped the Summer Line"
  }
}
'

{
  "status": 200,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "post": {
    "id": 7305,
    "slug": "how-we-shipped-the-summer-line",
    "title": "How We Shipped the Summer Line",
    "description": "A behind-the-scenes look at three months of work.",
    "image_url": "https://cdn.fluid.app/posts/7305.png",
    "canonical_url": "https://acme.fluid.app/home/blog/how-we-shipped-the-summer-line",
    "images": {
      "thumb": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      },
      "medium": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      },
      "large": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      }
    },
    "active": true,
    "status": "published",
    "publish_at": null,
    "seo": {
      "title": "Summer Sale — Up to 40% Off",
      "description": "Shop the July clearance event before it ends.",
      "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9215.png",
      "block_crawler": false,
      "id": 9215
    },
    "metafields": [
      {
        "namespace": "custom",
        "key": "material",
        "value": "<unknown>",
        "value_type": "single_line_text_field",
        "description": "The primary material used in this product",
        "created_at": "2026-05-01T12:00:00Z",
        "updated_at": "2026-05-01T12:00:00Z",
        "locked": false
      }
    ],
    "languages": [
      "en",
      "fr"
    ],
    "countries": [
      "GB",
      "US"
    ],
    "summary": "A short lead paragraph shown on listing cards.",
    "post_date": "2026-05-01",
    "post_author": "Dwight Schrute",
    "category_id": 4821,
    "collection_ids": [
      5102,
      5103
    ],
    "custom_slug": false
  }
}

{
  "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

Authorization

string

header

required

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

lang

string

Response locale. ISO code (e.g. fr, de). When omitted, responds in the company's default locale. On the public surface, falls back to en for any translated field missing in the requested locale.

Example:

"fr"

Body

application/json

post

object

required

Show child attributes

Response

The created Post.

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.

status

integer

required

Example:

200

meta

object

required

Response metadata included on every successful response body. request_id and timestamp are always present; list endpoints also add pagination.

Show child attributes

post

object

required

Authenticated (company-surface) Post read shape: the public PostBase plus custom_slug, admin metadata never rendered on the public surface.

Show child attributes

Company Posts index

Company Post show

curl --request POST \
  --url https://api.fluid.app/api/v202604/company/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "post": {
    "title": "How We Shipped the Summer Line"
  }
}
'

{
  "status": 200,
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "pagination": {
      "cursor": "<string>",
      "limit": 25,
      "prev_cursor": "<string>",
      "next_cursor": "<string>"
    }
  },
  "post": {
    "id": 7305,
    "slug": "how-we-shipped-the-summer-line",
    "title": "How We Shipped the Summer Line",
    "description": "A behind-the-scenes look at three months of work.",
    "image_url": "https://cdn.fluid.app/posts/7305.png",
    "canonical_url": "https://acme.fluid.app/home/blog/how-we-shipped-the-summer-line",
    "images": {
      "thumb": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      },
      "medium": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      },
      "large": {
        "url": "https://ik.imagekit.io/fluidapp/tr:w-600,c-at_max,f-auto,q-75/categories/4821.png",
        "width": 600
      }
    },
    "active": true,
    "status": "published",
    "publish_at": null,
    "seo": {
      "title": "Summer Sale — Up to 40% Off",
      "description": "Shop the July clearance event before it ends.",
      "image_url": "https://ik.imagekit.io/fluidapp/tr:w-1200,h-630,c-maintain_ratio,fo-auto,f-auto,q-80/seo/9215.png",
      "block_crawler": false,
      "id": 9215
    },
    "metafields": [
      {
        "namespace": "custom",
        "key": "material",
        "value": "<unknown>",
        "value_type": "single_line_text_field",
        "description": "The primary material used in this product",
        "created_at": "2026-05-01T12:00:00Z",
        "updated_at": "2026-05-01T12:00:00Z",
        "locked": false
      }
    ],
    "languages": [
      "en",
      "fr"
    ],
    "countries": [
      "GB",
      "US"
    ],
    "summary": "A short lead paragraph shown on listing cards.",
    "post_date": "2026-05-01",
    "post_author": "Dwight Schrute",
    "category_id": 4821,
    "collection_ids": [
      5102,
      5103
    ],
    "custom_slug": false
  }
}

{
  "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>"
    }
  }
}

Overview

Task guides

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Create a Post

Authorizations

Query Parameters

Body

Response