Skip to main content
POST
/
api
/
org-lists
/
{listType}
/
entries
Create a new org-list entry
curl --request POST \
  --url https://app.solya.app/api/org-lists/{listType}/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {
    "note": "Product arrived physically damaged"
  },
  "value": "damaged"
}
'
{
  "createdAt": "2026-06-05T10:00:00.000Z",
  "id": "entry-uuid-new",
  "listType": "RETURN_REASON_CODE",
  "metadata": {
    "note": "Product arrived physically damaged"
  },
  "updatedAt": null,
  "value": "DAMAGED"
}

Authorizations

​
Authorization
string
header
required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Path Parameters

​
listType
enum<string>
required

List type: SUPPLIER_BLACKLIST | BRAND_RESTRICTION | RETURN_REASON_CODE

Available options:
SUPPLIER_BLACKLIST,
BRAND_RESTRICTION,
RETURN_REASON_CODE

Body

application/json
​
value
string
required

Entry value. For SUPPLIER_BLACKLIST and BRAND_RESTRICTION, provide the UUID. For RETURN_REASON_CODE, provide a reason code string (normalized to upper-case server-side).

Required string length: 1 - 255
​
metadata
object

Optional metadata to attach to the entry (e.g. { note: 'Defective supplier' })

Response

Successful response

​
data
object
required
​
success
enum<boolean>
required
Available options:
true