Create User Pricing

POST 
/users/:lookupKey/:lookupValue/pricing

Use this endpoint to define pricing for an existing user. The user can be identified by it's lookup key. It is required to provide either categories or products or both in the payload.

Use cases

A common use case for this endpoint is when you want to give discounts only for a specific user.

If you want to give a discount of 20% of sales price on all products in a given category you can use the SP type pricing for a category. The user will have discounted prices on all products that belong in that category.

Another common use case is to set a specific price for a product only for a single user.

Request

Path Parameters

lookupKey stringrequired

Lookup key. Read more about user lookup keys

lookupValue stringrequired

The value of the key (id or sourceId)

application/json

Body

categories

object[]

Array [

id number

pricing

object

amount number

type string

]

products

object[]

Array [

id number

pricing

object

amount number

price number

type string

]

shopId number

Responses

200

Create User Pricing - 200

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• server

  string

• x-request-id

  string

application/json

Schema

Schema

data

object[]

Array [

action string

error string

key number

lookupKey string

success boolean

]

messages string[]
total number

Example (from schema)

{
  "data": [
    {
      "action": "create",
      "key": 1797,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "key": 77138,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "error": "product with id [1036522] not found",
      "key": 1036522,
      "lookupKey": "id",
      "success": false
    }
  ],
  "messages": [
    "completed"
  ],
  "total": 3
}

Create User Pricing - 200

{
  "data": [
    {
      "action": "create",
      "key": 1797,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "key": 77138,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "error": "product with id [1036522] not found",
      "key": 1036522,
      "lookupKey": "id",
      "success": false
    }
  ],
  "messages": [
    "completed"
  ],
  "total": 3
}

404

Create User Pricing - 404

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• server

  string

• x-request-id

  string

application/json

Schema

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 70007,
    "messages": [
      "Parent resource [User] with id [14699] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/70007",
    "status": 404,
    "type": "ParentUserNotFound"
  }
}

Create User Pricing - 404

{
  "error": {
    "code": 70007,
    "messages": [
      "Parent resource [User] with id [14699] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/70007",
    "status": 404,
    "type": "ParentUserNotFound"
  }
}

Loading...