Create a dealer user

Adds a user with the vendedor role (own-orders access, see Authentication) to the shop’s seller and emails them an invitation. Needs shops.write. A new user is created in the seller’s account with a random password the dealer replaces through the login page’s password reset; an existing user of the same account just gets the role. Other roles cannot be assigned here.

POST/shops/{shop_id}/admins

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

shop_idintegerrequired

Request body

requiredapplication/json

emailstringrequired

Lowercased on save. 422 if the user already has a role in the seller or belongs to another account.

namestring

Defaults to the part of the email before the @.

branch_idinteger

The sucursal (a branch of the seller) the dealer works at. 422 on $.branch_id if it is not one.

Responses

201

The created dealer user

403

Access denied

422

Invalid or unknown fields, or the user cannot be added

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

shop_idpath*

Bodyapplication/json

emailstring*Lowercased on save. `422` if the user already has a role in the seller or belongs to another account.namestringDefaults to the part of the email before the `@`.branch_idintegerThe sucursal (a branch of the seller) the dealer works at. `422` on `$.branch_id` if it is not one.

Request

curl -X POST 'https://api.onbolder.com/v2/shops/1/admins' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "string",
  "name": "string",
  "branch_id": 0
}'

const response = await fetch("https://api.onbolder.com/v2/shops/1/admins", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"email\": \"string\",\n  \"name\": \"string\",\n  \"branch_id\": 0\n}"
});

import requests

response = requests.post(
    "https://api.onbolder.com/v2/shops/1/admins",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"email\": \"string\",\n  \"name\": \"string\",\n  \"branch_id\": 0\n}",
)

Response

{
  "id": 11,
  "email": "ana@dealer.cl",
  "name": "Ana Dealer",
  "role": "vendedor",
  "disabled": false,
  "last_logged_on": null
}