iotoms Docs

Create a brand

POST
/api/v1/catalog/attributes/brands

Creates a brand and returns it with status 201. The response is the bare object, without the standard {status, message, data} envelope.

How to use it

  1. Send a unique, non-blank name.
  2. Use the returned id as brandId on items (Create an item); sales by brand then report under it.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Request Body

application/json
  1. body
id?|

Unique ID of the brand. Set by the server; use it as brandId on items.

Formatint64
name*string

Brand name. Required, must not be blank and must be unique for the merchant.

modifiedTime*string

When the brand was last saved. Filled in with the current time when you leave it out.

Formatdate-time

Response Body

OK

*/*
  1. response
id?|

Unique ID of the brand. Set by the server; use it as brandId on items.

Formatint64
name*string

Brand name. Required, must not be blank and must be unique for the merchant.

modifiedTime*string

When the brand was last saved. Filled in with the current time when you leave it out.

Formatdate-time
Example Request
curl -X POST 'https://beta.iotoms.com/api/v1/catalog/attributes/brands' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "modifiedTime": "2019-08-24T14:15:22Z"}'
Example Response
{  "id": 0,  "name": "string",  "modifiedTime": "2019-08-24T14:15:22Z"}