Storefront

Create hero slide

POST/api/v1/storefront/admin/hero-slides

Creates a new hero slide. Admin-only.

Requires Authorization

ADMIN only

Authenticated action

Form fields

`title`stringrequired
`subtitle`string
`linkUrl`string	Where the slide links to when clicked.
`position`number	Sort order. Lower numbers show first.
`isActive`boolean	Defaults to true.
`image`filerequired

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/storefront/admin/hero-slides \
  --header 'Authorization: Bearer <access_token>' \
  --form 'title=<title>' \
  --form 'subtitle=<subtitle>' \
  --form 'linkUrl=<linkUrl>' \
  --form 'position=<position>' \
  --form 'isActive=<isActive>' \
  --form 'image=@/path/to/file.jpg'

201Example response

{
  "success": true,
  "data": {
    "id": "slide_1a2b3c",
    "title": "Soldes de rentrée",
    "subtitle": "Jusqu'à -30% sur une sélection de produits",
    "imageUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/storefront/hero1.jpg",
    "linkUrl": "/products?category=electronics",
    "position": 1,
    "isActive": true,
    "createdAt": "2026-01-10T08:00:00.000Z"
  }
}