Skip to main content
POST
/
api
/
v2
/
apps
/
{app_id}
/
branches
curl -X POST "https://ecommerce.jelou.ai/api/v2/apps/{app_id}/branches" \
  -H "Authorization: Bearer <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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
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.
To assign a language to the branch, store it in properties.language. Supported values: es, en, pt.
curl -X POST "https://ecommerce.jelou.ai/api/v2/apps/{app_id}/branches" \
  -H "Authorization: Bearer <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"
  }
}
To create multiple branches in a single call, use POST /api/v2/apps/{app_id}/branches/batch with a { "resources": [...] } body.