Products / Entity

Create Product

This endpoint allows you to create a Product based on JSON input.

You will only be able to create a Product after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST BODY

AttributeTypeDescription
categoryIdObject, NullId of the Category that the Product belongs to (see Categories resource)
costNumberCost of the Product
descriptionStringDescription of the Product
extIdStringExternal ID of the Product from a third party system (ERP, CRM, Accounting System)
familyIdIntegerId of the Family that the Product belongs to (see Families resource)
maxDiscountNumberMaximum discount that can be applied to the Product in percents
model (Required)StringProduct name
notAvailableBooleanIf true, the Product is not available
permissionLevelIntegerDefines the visibility of the Product. Set from 1 to 5 being 5 the highest level of permission
priceNumberSpecific price for the Product
stockIntegerAmount of Product in stock
readOnlyBooleanIf true, the Product can not be modified or deleted

RESPONSE

Returns a JSON with information about the Product just created.

AttributeTypeDescription
idIntegerId assigned to the new Product
MessageStringShows the operation status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
post/products

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/products
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Request body

categoryIdinteger
costinteger
descriptionstring
familyIdinteger
maxDiscountinteger
permissionLevelinteger
pricenumber

Response

Create Product

Changes

No recorded changes to this operation across all 1 revision of this API.