Zid Docs
Apps
ThemesPayments
Apps
ThemesPayments
Help Center
Slack
  1. Posts
  • 🗂️ Overview
  • 🚀 Start Here
  • Create your First App
  • Responses
  • Rate Limiting
  • Authorization
  • Embedded Apps
  • StoreFront Events
  • Zid MUI
  • Zid SDKs
  • Our custom MCP server
  • Merchant APIs
    • Account
      • Me
        • Me
        • Profile
      • Store
        • Store
        • Branding
        • Localization
        • Social
        • Operations
        • Business
        • Upload Logo Image
        • Delete Logo Image
        • Upload Icon Image
        • Delete Icon Image
        • Upload Cover Image
        • Delete Cover Image
    • Orders
      • Validate Order Request
      • Create Order
      • Change Order Status
      • Add Order Comment
      • View Order
      • List Orders
      • List Custom Order Statuses
      • List Order Credit Notes
    • Reverse Orders
      • Create Reverse Orders
      • Create Reverse Orders Waybill
      • Add Reverse Order Reasons
      • List Reverse Reasons
      • Calculate Reverse Totals
      • Create refund for reverse order
      • Upload bank transfer receipt
      • Update return products
      • Order Details – View for Return
    • Abandoned Carts
      • List Carts
      • View Cart
    • Products
      • Managing Products
        • Create Product Types
        • Create Product
        • List Products
        • View Product
        • List Product Settings
        • Update Product
        • Bulk Update Products
        • Delete Product
      • Digital Vouchers
        • List Vouchers
        • Order Vouchers
        • Create Voucher
        • Import Vouchers
        • Export Vouchers
        • Update Voucher
        • Remove Voucher
      • Product Categories
        • List Categories
        • View Category
        • Create Category
        • Create Subcategory
        • Update Category
        • Assign Product to Category
        • Bulk Assign Products to Category
        • Publish Category
        • Detach Category from All Products
        • Remove Product from Category
      • Product Badge
        • List Badges
      • Product Attributes
        • List Attributes
        • View Attribute
        • Create Attribute
        • Update Attribute
        • Delete Attribute
      • Product Attribute Presets
        • List Presets
        • Create Preset
        • Update Preset
        • Delete Preset
      • Product Variants
        • Create Variants
        • Create Custom Option
        • Update Custom Option
        • Delete Custom Option Field
        • Create Custom Input Field
        • Update Custom Input Field
        • Delete Custom Input Field
      • Product Sorting
        • Set Manual Product Order
        • Reset Manual Product Order
      • Product Images
        • List Images
        • Upload Image
        • Update Image Order
        • Delete Image
      • Product Availability Notifications
        • Notification Stats
        • Noticiation Settings
        • List Notifications
        • Create Notification
        • Update Settings
        • Send Notification Email
        • Export Notifications
      • Product Export
        • Email All Products to Store Owner
        • Import Products via CSV or xlsx File
      • Product Stock
        • Retrieve Product Stock
        • List Product Stock Records
        • Create Product Stock
        • Update Product Stock
        • Bulk Update Product Stock Records
      • Product Questions & Answers
        • Retrieve Product Question
        • Retrieve Product Answer
        • List Product Questions
        • List Answers for Question
        • Create Product Question
        • Create Product Answer
        • Update Product Question
        • Update Product Answer
        • Delete Product Question
        • Delete Product Answer
      • Product Reviews
        • List Reviews
        • Count Reviews
      • Digital Products
        • Create Downloadable Product
        • Generate Upload URL
        • Upload File to S3
        • Create Product Downloadable
        • Get Product Downloadables
        • Delete Product Downloadable
        • List Store Downloadables
        • Create Store Downloadable
        • Delete Store Downloadable
    • Inventories
      • Create Location
      • Update Location
      • Update Product Stock for Location
      • List Locations
      • View Location
    • Shipping
      • List Store Shipping Methods
    • Marketing
      • Coupons
        • List Coupons
        • View Coupon
        • Create Coupon
        • Generate Bulk Coupons
        • Duplicate Coupon
        • Duplicate Bulk Coupons
        • Update Coupon Note
        • Update Coupon
        • Update Bulk Coupons
        • Update Coupon Status
        • Update Bulk Coupons Status
        • Delete Coupon
        • Delete Bulk Coupons
      • Bundle Offers
        • List Bundle Offers
      • Loyalty Program
        • Loyalty Program Status
        • Loyalty Program Details
        • Loyalty Program Info
        • Customer Loyalty Summary
        • Customer Points History
        • Activate Loyalty Program
        • Set Points Expiration Rules
        • Update Cashback Rule
        • Create Points Redemption Method
        • Update Points Redemption Method
        • Delete Points Redemption Method
        • Adjust Customer Points
      • Discount Rules
        • List Discount Rules
        • View Discount Rule
        • Create Discount Rule
        • Update Discount Rule
    • Customers
      • Customer Tags
        • List Customer Tags
        • Add Customer Tag
        • ْUpdate Customer Tag
        • Delete Customer Tag
      • List Customers
      • View Customer
      • Primary Customer List
      • FInd Customer By Phone Number
      • Customer Profile
      • Add Customer
      • Update Customer
      • Delete Customer
      • Add Bulk Customers
      • Import Customers
    • Store Settings
      • 📄 User Roles and Permissions
      • Retrieve Store Manager Profile
      • Retrieve VAT Settings
      • List Payment Methods
      • List Store Operating Countries
    • Countries and Cities
      • List Countries
      • List Cities for Country
    • Blogs
      • Settings
        • Create
        • List
      • Categories
        • Create
        • List
        • Bulk Activate
        • Bulk Deactivate
        • Bulk Delete
        • Retrieve
        • Destroy
        • Partial Update
        • Bulk Add To Posts
        • Bulk Remove From Posts
      • Posts
        • Media
          • List
          • Create
          • Destroy
        • Create
          POST
        • List
          GET
        • Retrieve
          GET
        • Partial Update
          PATCH
        • Destroy
          DELETE
        • Archive
          POST
        • Publish
          POST
        • Bulk Archive
          POST
        • Bulk Publish
          POST
        • Bulk Delete
          POST
        • Export Posts
          GET
        • Import Template
          GET
        • Import Posts
          POST
      • Tags
        • Create
        • List
        • Retrieve
        • Partial Update
        • Destroy
        • Bulk Delete Tags
        • Bulk Add To Posts
        • Bulk Remove From Posts
      • Storefront
        • Posts
          • List
          • Retrieve
        • Categories
          • List
          • Retrieve
        • Tags
          • List
  • Webhooks
    • Overview
    • Webhook Health Tracking
    • Events
      • Order
      • Product
      • Abandoned Cart
      • Customer
      • Product Category
    • APIs
      • Health Summary
      • Broken Webhooks
      • Recover Broken Webhooks
      • List Webhooks
      • Create Webhook
      • Delete Webhook
      • Delete Webhook By subscriber
  • App Management
    • Events
    • APIs
      • Subscription Details
      • Update Usage-Based Charges
  1. Posts

Create

POST
https://api.zid.sa/v2/blogs/posts/

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Created
Headers

Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v2/blogs/posts/' \
--header 'store-id: {{StoreId}}' \
--header 'x-manager-token: {{Access-Token}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "title": "title string",
  "slug": "string",
  "snippet": {
    "ar": "نص عربي",
    "en": "English text"
  },
  "content": {
    "ar": "نص عربي",
    "en": "English text"
  },
  "status": "frozen",
  "published_at": "2008-03-28T13:44:37.028Z",
  "scheduled_at": "1955-10-15T11:30:57.161Z",
  "display_order": 5111,
  "category_id": "019efe2f-2d93-7bb2-8996-330f8a68ce27",
  "tag_ids": null,
  "products": [
    {
      "product_id": "ed8a1f4f-d511-0830-a909-4ea1d0817a06",
      "relation": null,
      "label": {
        "ar": "نص عربي",
        "en": "English text"
      },
      "display_order": null
    },
    {
      "product_id": "8f548fed-d591-48a5-139e-abb58d6dd2b7",
      "relation": "featured",
      "label": {
        "ar": "نص عربي",
        "en": "English text"
      },
      "display_order": null
    }
  ],
  "seo": null,
  "recommended_posts_mode": "automatic",
  "recommended_posts_ids": [
    "ceb7a925-f7fc-cf6b-097c-1d6ce23d2d00",
    "4af486cf-3e2d-bd0a-0318-795dea97ef6b"
  ],
  "recommended_products_mode": null,
  "recommended_products_ids": [
    "659552bc-54f7-034e-0f0b-e5a292926adb",
    "7ffeb0ac-d934-e57a-3b6f-3696836eb5a2"
  ]
}'
Response Response Example
Created
{
    "id": "019efe66-02be-7123-aaed-59b62a960c92",
    "store_id": 3,
    "title": {
        "ar": "title string",
        "en": "title string"
    },
    "slug": "string",
    "snippet": {
        "ar": "نص عربي",
        "en": "English text"
    },
    "content": {
        "ar": "نص عربي",
        "en": "English text"
    },
    "status": "frozen",
    "published_at": null,
    "scheduled_at": "1955-10-15T11:30:57.161000Z",
    "display_order": 5111,
    "seo": {
        "id": "019efe66-02c2-79a1-89f7-5d68ab1c0faa",
        "title": {},
        "description": null,
        "created_at": "2026-06-25T10:49:18.786540Z",
        "updated_at": "2026-06-25T10:49:18.786564Z"
    },
    "cover": null,
    "category": {
        "id": "019efe2f-2d93-7bb2-8996-330f8a68ce27",
        "name": {
            "ar": "نص عربي",
            "en": "English text"
        },
        "slug": "string2",
        "icon": "string"
    },
    "tags": [],
    "products": [
        {
            "id": "019efe66-02de-7330-90b1-0c9230f3ef79",
            "post_id": "019efe66-02be-7123-aaed-59b62a960c92",
            "product_id": "659552bc-54f7-034e-0f0b-e5a292926adb",
            "relation": "recommended",
            "label": {},
            "display_order": 0
        },
        {
            "id": "019efe66-02de-7330-90b1-0ca59195c612",
            "post_id": "019efe66-02be-7123-aaed-59b62a960c92",
            "product_id": "7ffeb0ac-d934-e57a-3b6f-3696836eb5a2",
            "relation": "recommended",
            "label": {},
            "display_order": 1
        },
        {
            "id": "019efe66-02cc-70e0-8d57-a0ec81a29999",
            "post_id": "019efe66-02be-7123-aaed-59b62a960c92",
            "product_id": "8f548fed-d591-48a5-139e-abb58d6dd2b7",
            "relation": "featured",
            "label": {
                "ar": "نص عربي",
                "en": "English text"
            },
            "display_order": 1
        }
    ],
    "recommended_posts_mode": "automatic",
    "recommended_products_mode": "disabled",
    "recommended_post_ids": [
        "ceb7a925-f7fc-cf6b-097c-1d6ce23d2d00",
        "4af486cf-3e2d-bd0a-0318-795dea97ef6b"
    ],
    "recommended_product_ids": [
        "659552bc-54f7-034e-0f0b-e5a292926adb",
        "7ffeb0ac-d934-e57a-3b6f-3696836eb5a2"
    ],
    "created_at": "2026-06-25T10:49:18.782959Z",
    "updated_at": "2026-06-25T10:49:18.782987Z"
}
Modified at 2026-06-29 10:41:14
Previous
Destroy
Next
List
Built with