Skip to main content
POST
/
ecommerce
/
v2
/
apps
/
{app_id}
/
branches
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Downtown Branch",
    "code": "BRANCH-DOWNTOWN",
    "address": "123 Main Ave, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    }
  }'

{
  "data": {
    "id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
    "name": "Downtown Branch",
    "code": "BRANCH-DOWNTOWN",
    "address": "123 Main Ave, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    },
    "created_at": "2026-02-19T15:30:00.000000Z",
    "updated_at": "2026-02-19T15:30:00.000000Z"
  }
}
​
app_id
string
required
Your store ID in Jelou Shop.
​
name
string
required
Branch name (max. 255 characters).
​
code
string
required
Unique branch code within the store (max. 255 characters).
​
address
string
Branch address (max. 255 characters).
​
phone
string
Branch phone number (max. 255 characters).
​
status
boolean
default:"true"
Branch status (active/inactive).
​
properties
object
JSON object with custom branch properties. You can include any of your own keys; the language key is validated.
The code must be unique per store. If you try to create two branches with the same code in the same store, you will receive a validation error.
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Downtown Branch",
    "code": "BRANCH-DOWNTOWN",
    "address": "123 Main Ave, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    }
  }'

{
  "data": {
    "id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
    "name": "Downtown Branch",
    "code": "BRANCH-DOWNTOWN",
    "address": "123 Main Ave, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    },
    "created_at": "2026-02-19T15:30:00.000000Z",
    "updated_at": "2026-02-19T15:30:00.000000Z"
  }
}
Batch operations: you can manage multiple branches in a single call using the /ecommerce/v2/apps/{app_id}/branches/batch endpoint:
  • POST — create multiple branches with a { "resources": [ { ... }, { ... } ] } body.
  • PATCH — update multiple branches with { "resources": { "<branch_id>": { ... } } }.
  • DELETE — delete multiple branches with { "resources": ["<branch_id>", "<branch_id>"] }.
The batch response returns the affected branches inside data.