Shops

Create shop

POST/api/v1/seller/shop

Creates a shop under the seller's profile. A seller can own multiple shops, up to their plan's shop limit.

Requires Authorization

SELLER only

Authenticated action

Form fields

`name`stringrequired
`description`stringrequired
`deliveryFee`numberrequired
`deliveryFeeCurrency`stringrequired	USD or CDF.
`logo`filerequired
`banner`filerequired

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/seller/shop \
  --header 'Authorization: Bearer <access_token>' \
  --form 'name=<name>' \
  --form 'description=<description>' \
  --form 'deliveryFee=<deliveryFee>' \
  --form 'deliveryFeeCurrency=<deliveryFeeCurrency>' \
  --form 'logo=@/path/to/file.jpg' \
  --form 'banner=@/path/to/file.jpg'

201Example response

{
  "success": true,
  "data": {
    "id": "shop_2b3c4d",
    "sellerProfileId": "sp_2b3c4d",
    "name": "Boutique Aline",
    "slug": "boutique-aline",
    "description": "Produits alimentaires et boissons en gros et au détail.",
    "logoUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/shops/aline-logo.jpg",
    "bannerUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/shops/aline-banner.jpg",
    "deliveryFee": "2.00",
    "deliveryFeeCurrency": "USD",
    "status": "DRAFT",
    "createdAt": "2026-01-08T09:00:00.000Z"
  }
}