Create Contact Pricing

POST 
/contacts/:lookupKey/:lookupValue/pricing

Use this endpoint to define pricing for an existing contact. The contact 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 contact of the company.

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 contact 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 contact.

Request

Path Parameters

lookupKey stringrequired

Lookup key. Read more about contact 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 Contact Pricing - 200

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• x-request-id

  string

application/json

Schema

Schema

data

object[]

Array [

action 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",
      "key": 86011,
      "lookupKey": "id",
      "success": true
    }
  ],
  "messages": [
    "Completed"
  ],
  "total": 3
}

Create Contact Pricing - 200

{
  "data": [
    {
      "action": "create",
      "key": 1797,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "key": 77138,
      "lookupKey": "id",
      "success": true
    },
    {
      "action": "create",
      "key": 86011,
      "lookupKey": "id",
      "success": true
    }
  ],
  "messages": [
    "Completed"
  ],
  "total": 3
}

404

Create Contact Pricing - 404

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  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": 50007,
    "messages": [
      "Parent resource [Contact] with id [25494] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/70007",
    "status": 404,
    "type": "ParentContactNotFound"
  }
}

Create Contact Pricing - 404

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

Loading...