Create a retailer with its users

POST/v1/retailersFactory API keyBase URL api.skuflo.io

The only way a retailer can exist.

Body parameters#

Name	Type	Description
`name`required	`string`	·
`code`required	`string`	·
`email`required	`string (email)`	·
`delivery_days`optional	`string`	·
`can_order`optional	`boolean`	·
`show_prices`optional	`boolean`	·
`users`required	`object[]`	·
`name`required	`string`	·
`email`required	`string (email)`	·
`role`required	`string`	· One of `"owner", "buyer", "viewer", "accounts", "integrations"`

Responses#

Status	Meaning
200	Success. An example body is in the column on the right.

Other errors#

Status	Meaning
401	No key, or the key is not recognised.
402	`billing_required`. Reading always works, but this is a write and stops once a trial ends or a plan is cancelled.
403	The key is valid but its role cannot do this.
422	The body failed validation. The response lists every problem at once.
429	More than 600 requests a minute. Wait `retry-after` seconds.

Request

curl -X POST "https://api.skuflo.io/v1/retailers" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Loading bay 1",
    "code": "K7Q2M9XR",
    "email": "ops@your-retailer.example",
    "users": [
      {
        "name": "Loading bay 1",
        "email": "ops@your-retailer.example",
        "role": "owner"
      }
    ],
    "delivery_days": "Mon,Wed,Fri",
    "can_order": true,
    "show_prices": true
  }'

Create a retailer with its users

Body parameters#

Responses#

Other errors#

Related#