Bulk Users by Id
POST/users/bulk/id
The bulk endpoints offer an efficient way of importing/updating large amounts of user with just a single API call. When using the bulk id
endpoint, the products are identified by id
. If a user doesn't already exist, it will be created. If it does exist, the user found will be updated.
User Bulk endpoints support bulk change of user attributes for multiple users as well. To learn more about Attributes, go here.
User Bulk endpoints support bulk change of pricing for multiple users as well. To learn more about Pricing, go here.
A single users attributes can be modified as explained in Bulk resource attribute values by resource lookup key, but if it's needed to modify attributes for multiple users, this endpoint should be used.
Fields
Name | Required |
---|---|
users (array of users) | yes |
id | yes |
debtorId | no |
firstName | no |
middleName | no |
lastName | no |
fullName | no |
title | no |
dateOfBirth | no |
gender | no |
login | no |
phone | no |
email | no |
company | no |
parent | no |
pricelistAmount | no |
pricelistPercentage | no |
taxNumber | no |
cocNumber | no |
primaryLanguage | no |
sourceId | no |
source | only when sourceId is provided |
attributes Read more about attributes | no |
pricing Read more about pricing | no |
addresses Read more about addresses | no |
Request
- application/json
Body
Array [
Array [
]
]
users
object[]
attributes
object[]
parent
object
Responses
- 200
- 400
Bulk Users by Id - 200
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Bulk Users by Id - 200
Schema
Array [
]
data
object[]
{
"data": [
{
"action": "update",
"id": 14713,
"key": 3002196,
"lookupKey": "sourceId",
"success": true
}
],
"messages": [
"Completed"
],
"total": 1
}
{
"data": [
{
"action": "update",
"id": 14713,
"key": 3002196,
"lookupKey": "sourceId",
"success": true
}
],
"messages": [
"Completed"
],
"total": 1
}
Bulk Users by Id - 400 (invalid schema)
Response Headers
Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string
- application/json
- Schema
- Example (from schema)
- Bulk Users by Id - 400 (invalid schema)
Schema
error
object
{
"error": {
"code": 10007,
"messages": [
"#/users/0: required key [firstName] not found"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}
{
"error": {
"code": 10007,
"messages": [
"#/users/0: required key [firstName] not found"
],
"moreInfo": "https://www.propel.us/docs/errors/10007",
"status": 400,
"type": "SchemaValidationException"
}
}