Skip to content

List custom fields

GET
/products/{productId}/custom-fields
curl --request GET \
--url 'https://api.motenya.app/v1/products/example/custom-fields?entity=contact' \
--header 'Authorization: Bearer <token>'

The extra fields defined for contacts, clients, catalog items, orders and subscriptions, and the keys their custom values use.

Requires crm:read.

productId
required
string
>= 1 characters <= 64 characters
entity
string
Allowed values: contact client catalog_item order subscription

Success

Media typeapplication/json
Array<object>
object
id
required
string
>= 1 characters <= 64 characters
entity
required
string
Allowed values: contact client catalog_item order subscription
key
required
string
label
required
string
type
required
string
Allowed values: text number money date boolean select multiselect url
options
required
Array<object>
object
key
required
string
label
required
string
archived
required
boolean
required
required
boolean
filterable
required
boolean
onCard
required
boolean
position
required
integer
archived
required
boolean
createdAt
required
string
updatedAt
required
string
key
additional properties

Example

[
{
"entity": "contact",
"type": "text"
}
]

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing, invalid, revoked or expired API key

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing scope, API turned off, published article without publish scope, or account suspended

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Not found, or outside the knowledge bases this key may use

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Slug or translation already exists

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rejected by validation (e.g. unknown language or category)

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rate limited; see Retry-After

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Internal error