Add items

Use this method to add items to a specific catalog.

NOTE
Response details:

  • This endpoint only returns successful results
  • Other results are ignored
  • Errors are not returned

NOTE
  • Maximum of 1000 item field values are allowed.
Please log in to see full path URL. Learn why.
post
/catalogs/1/catalogs/{catalogId}/items
Request rate limit:
5 requests / second (per account)
path Parameters

catalogId
required
integer <int64>
Example: 10000

Catalog id.

Request Body schema:
application/json
collapse all -
Array
values
required
Array of objects

A list of item field values. Maximum 1000 values.

Array
fieldName
string

Field name.

fieldId
string

Field ID.

value
required
string

Field value.

Responses

200

Successful Response

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

429

Too Many Requests

500

Internal Server Error

Request samples

Content type
application/json
Copy
Collapse all
[
  • {
    • "values":
      [
      • {
        • "fieldName": "Custom field name",
        • "fieldId": "8b00a8c6-5302-4fd0-a0cc-bb090b28ac34",
        • "value": "Custom field value"
        }
      ]
    }
]

Response samples

Content type
Copy
Collapse all
[
  • {
    • "id": 10000,
    • "values":
      [
      • {
        • "fieldName": "Text field",
        • "fieldId": "caad56e4-2a1c-4ae8-9717-ebb40d05533d",
        • "value": "Some text value"
        },
      • {
        • "fieldName": "Number field",
        • "fieldId": "1ab3e732-8986-4d70-bdec-f89c3cbf042d",
        • "value": "2"
        },
      • {
        • "fieldName": "Decimal field",
        • "fieldId": "87897d8f-07ae-4b51-80a8-84db793144fb",
        • "value": "2,0005"
        },
      • {
        • "fieldName": "Boolean field",
        • "fieldId": "87897d8f-07ae-4b51-80a8-ebb40d05533d",
        • "value": "false"
        },
      • {
        • "fieldName": "Date field",
        • "fieldId": "caad56e4-07ae-4ae8-9717-ebb40d05533d",
        • "value": "2022-01-12"
        },
      • {
        • "fieldName": "Time field",
        • "fieldId": "87897d8f-8986-4d70-bdec-f89c3cbf042d",
        • "value": "10:10:10"
        },
      • {
        • "fieldName": "Date time field",
        • "fieldId": "87897d8f-07ae-8986-80a8-ebb40d05533d",
        • "value": "2022-01-12 10:10:10"
        }
      ]
    },
  • {
    • "id": 10001,
    • "values":
      [
      • {
        • "fieldName": "Text field",
        • "fieldId": "caad56e4-2a1c-4ae8-9717-ebb40d05533d",
        • "value": "Some text value 3"
        },
      • {
        • "fieldName": "Number field",
        • "fieldId": "1ab3e732-8986-4d70-bdec-f89c3cbf042d",
        • "value": "23"
        },
      • {
        • "fieldName": "Decimal field",
        • "fieldId": "87897d8f-07ae-4b51-80a8-84db793144fb",
        • "value": "22,0005"
        },
      • {
        • "fieldName": "Boolean field",
        • "fieldId": "87897d8f-07ae-4b51-80a8-ebb40d05533d",
        • "value": "false"
        },
      • {
        • "fieldName": "Date field",
        • "fieldId": "caad56e4-07ae-4ae8-9717-ebb40d05533d",
        • "value": "2022-01-13"
        },
      • {
        • "fieldName": "Time field",
        • "fieldId": "87897d8f-8986-4d70-bdec-f89c3cbf042d",
        • "value": "12:10:10"
        },
      • {
        • "fieldName": "Date time field",
        • "fieldId": "87897d8f-07ae-8986-80a8-ebb40d05533d",
        • "value": "2022-01-13 12:10:10"
        }
      ]
    }
]
Encountering issues Contact our support
What's new? Check out Release Notes
Unsure about a term? See Glossary
Research panel

Help shape the future of our products

Learn more
Service statusCopyright @ 2006-2025 Infobip ltd.