Create Attribute Description

POST 
/v2/attribute-descriptions

Creates a new Attribute Description

Request

application/json

Body

required

The Attribute Description to create

namestringrequired
Descriptive identifier (Screaming Snake Case)
Example: ATTRIBUTE_NAME

descriptions

object[]

required

Attribute descriptions per language

Array [

languagestringrequired

Localized field language code

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuestringnullablerequired

Localized field value

Example: example value

]

units

object[]

Attribute unit per language

Array [

languagestringrequired

Localized field language code

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuestringnullablerequired

Localized field value

Example: example value

]

typestringrequired
Attribute type. One of: [text, enum, color, datetime, integer, decimal]
Possible values: [text, enum, color, datetime, integer, decimal]
Example: color
attributeClassstringrequired
Attribute class. One of: [product, category, cluster, customer, contact, company]
Possible values: [product, category, cluster, customer, contact, company]
Example: customer
valuesetIdinteger
Unique identifier for the connected valueset
Example: 1234
groupstring
The attribute group
Possible values: <= 64 characters
Example: GROUP_NAME
isSearchableboolean
Flags whether this attribute should be used when generating catalog page filters
Default value: true
Example: true
isPublicboolean
Flags whether this attribute should be used when generating product specifications.
Default value: true
Example: true
isSystemboolean
Flags whether this attribute is only available to system users
Default value: false
Example: false
isHiddenboolean
Flags whether this attribute is hidden and should only be used for background operations.
Default value: false
Example: false

defaultValue

object

required

textValues

object[]

Attribute value descriptions per language, required for TEXT type attributes

Array [

languagestringrequired

Language is set as 2 character country code.

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuesarray[]

List of localized string values

Example: ["Hello","World"]

]

enumValuesstring[]

Attribute enum values, required for ENUM type attributes

Example: ["VALUE_1","VALUE_2"]

intValueinteger

Attribute integer value, required for INTEGER type attributes

Example: 42

decimalValuenumber

Attribute decimal value, required for DECIMAL type attributes

Example: 9.99

dateTimeValuedate-timenullable

Attribute datetime value, required for DATETIME type attributes

Example: 2021-01-01T00:00:00Z

colorValuestring

Attribute color value, required for COLOR type attributes

Example: #000000

Responses

201

The created Attribute description

application/json

Schema

Schema

iduuidrequired
Attribute description primary identifier
Example: e1de4af7-7301-44bc-a2d7-02342310ea34
namestringrequired
Descriptive identifier for this AttributeDescription
Example: ATTRIBUTE_NAME

descriptions

object[]

required

The human readable description of the attribute's name. This is a language specific value.

Array [

languagestringrequired

Language is set as 2 character country code.

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuestring

Localized field value

Example: example value

]

units

object[]

nullable

required

Attribute unit per language

Array [

languagestringrequired

Language is set as 2 character country code.

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuestring

Localized field value

Example: example value

]

attributeClassstringrequired

The class for this attribute. One of: [product, category, cluster, customer, contact, company]

Possible values: [text, enum, color, datetime, integer, decimal]

typestringrequired

Attribute class. One of: [product, category, cluster, customer, contact, company]

Possible values: [product, category, cluster, customer, contact, company]

valuesetIdinteger
The ID of the connected valueset to use when type is ENUM
Example: 1234
groupstring
The group this attribute belongs to, generally linked to a valueset.
Example: ATTRIBUTE_GROUP
isSearchablebooleanrequired
Flags whether this attribute should be used when generating catalog page filters
Default value: false
Example: true
isPublicbooleanrequired
Flags whether this attribute should be used when generating product specifications.
Default value: true
Example: true
isSystembooleanrequired
Flags whether this attribute is only available to system users
Default value: false
Example: false
isHiddenbooleanrequired
Flags whether this attribute is hidden and should only be used for background operations.
Default value: false
Example: false
createdAtdate-timerequired
Attribute description creation date
Example: 2022-01-01T00:00:00.000Z
lastModifiedAtdate-timerequired
Attribute description last modified date
Example: 2022-01-02T00:00:00.000Z
createdByintegernullablerequired
The userId of the user that created the attribute description
Example: 1234
lastModifiedByintegernullablerequired
The userId of the user that last modified the attribute description
Example: 1234

defaultValue

object

required

The default value for this attribute

oneOf

AttributeTextValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

textValues

object[]

required

Attribute textValues per language

Array [

languagestringrequired

Language is set as 2 character country code.

Possible values: >= 2 characters and <= 2 characters

Example: EN

valuesarray[]

List of localized string values

Example: ["Hello","World"]

]

AttributeEnumValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

enumValuesstring[]required

Attribute enum values

Example: ["VALUE_1","VALUE_2"]

AttributeIntValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

intValueintegerrequired

Attribute integer value

Example: 1234

AttributeDecimalValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

decimalValuefloatrequired

Attribute decimal value

Example: 1234.5678

AttributeColorValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

colorValuestringnullablerequired

Attribute color value, stored as a hex string

Example: #FFFFFF

AttributeDateTimeValue

iduuidrequired

Unique identifier of the attribute value

Possible values: >= 36 characters and <= 36 characters

Example: e1de4af7-7301-44bc-a2d7-02342310ea34

createdAtdate-time

Attribute value creation date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-01T00:00:00.000Z

lastModifiedAtdate-time

Attribute value last modified date

Default value: CURRENT_TIMESTAMP

Example: 2022-01-02T00:00:00.000Z

createdByinteger

The userId of the user that created the attribute value

Example: 1234

lastModifiedByinteger

The userId of the user that last modified the attribute description

Example: 1234

dateTimeValuedate-timenullablerequired

Attribute decimal value

Example: 2020-01-01T00:00:00.000Z

Example (from schema)

{
  "id": "e1de4af7-7301-44bc-a2d7-02342310ea34",
  "name": "ATTRIBUTE_NAME",
  "descriptions": [
    {
      "language": "NL",
      "value": "Dutch desc."
    },
    {
      "language": "DE",
      "value": "German desc."
    }
  ],
  "units": [
    {
      "language": "NL",
      "value": "Dutch unit."
    },
    {
      "language": "DE",
      "value": "German unit."
    }
  ],
  "attributeClass": "text",
  "type": "product",
  "valuesetId": 1234,
  "group": "ATTRIBUTE_GROUP",
  "isSearchable": true,
  "isPublic": true,
  "isSystem": false,
  "isHidden": false,
  "createdAt": "2022-01-01T00:00:00.000Z",
  "lastModifiedAt": "2022-01-02T00:00:00.000Z",
  "createdBy": 1234,
  "lastModifiedBy": 1234,
  "defaultValue": {}
}

400

Bad request

401

Unauthorized

application/json

Schema

Schema

any

invalid_client_id

{
  "ErrorCode": "invalid_client",
  "Error": "ClientId is Invalid"
}

invalid_client_cred

{
  "ErrorCode": "invalid_client",
  "Error": "Client credentials are invalid"
}

409

Attribute Description already exists

500

Unknown create Attribute Description error