Creates a new item for a Custom Entity type, identified by its denominator, from the supplied JSON object. On success returns 201 Created with the new resource location in the Location header.
Requires a valid API key in the X-API-KEY header.
Culture used to interpret the localized field values supplied in the request body.
- omitted / null: tenant's default culture.
- culture-code (e.g.
en-US,es): the specified culture.
A single JSON object whose properties match the writable fields published by /CustomEntities('{denominator}')/$metadata. The body is normalized before reaching the application layer:
- Must be a non-empty JSON object.
- A JSON array is accepted only if it contains exactly one element.
- Values are coerced to CLR primitives (
string,long,double,bool,null), nested objects and arrays. - A date attribute is a date and time with no time zone, stored and returned as written (
"2026-10-21T16:22:00"). A value withZor an offset (2026-10-21T14:22:00Z) is converted to its date and time in Spain (Europe/Madrid), the time the app shows (2026-10-21T16:22:00). System dates (_creation,_modify) are set by the service.
201 Created — The Location header points to the new resource: /CustomEntities('{denominator}')/Item({id}). No response body: the identifier of the new item is the {id} at the end of Location.
That address is the one PATCH and DELETE take for the item; there is no GET on it. To read the new item, filter the custom entity by its identifier: GET /CustomEntities('{denominator}')?$filter=abcd_id eq {id}.
- 400 Bad Request — The body cannot be written: empty, an array of more than one object, an attribute the entity does not have, one that cannot be assigned or a value the attribute does not take. Answered as a message naming why, a JSON string (
"Value: ZZ not allowed","Invalid attribute name: nope_field"). - 401 Unauthorized — Missing or invalid API key. Returned by the API gateway as
{ "message": "Unauthorized", "request_id": "d8aafa5b8f3e400b60bea0123dd33317" }. - 403 Forbidden — The API key does not have write permissions for this operation.
- 404 Not Found — A file or image the body references does not exist (
"Missing file name(s):photo.jpg."). - 500 Internal Server Error — Unexpected technical error.
Request:
POST /CustomEntities('Brand') HTTP/1.1
X-API-KEY: your-api-key-here
Accept-Language: en-US
Content-Type: application/json
{
"abcd_title": "Acme",
"abcd_description": "Acme brand"
}Response:
HTTP/1.1 201 Created
Location: /CustomEntities('Brand')/Item(42)- Sales Layer Catalog APIhttps://api2.saleslayer.com/catalog/CustomEntities('{customEntityDenominator}')
curl -i -X POST \
'https://api2.saleslayer.com/catalog/CustomEntities('\''{customEntityDenominator}'\'')' \
-H 'Accept-Language: string' \
-H 'Content-Type: application/json' \
-H 'X-API-KEY: string'No content