user
/user
/user
// Internal API. User API has no value to merchants.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Insert a group on the UltraCart account.
SDK Function Name: insertGroup
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
group | Group to insert | body | Group | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Delete a group on the UltraCart account.
SDK Function Name: deleteGroup
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
group_oid | The group_oid to delete. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Retrieves a single group using the specified group id.
SDK Function Name: getGroup
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
group_oid | The group id to retrieve. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Update a group on the UltraCart account.
SDK Function Name: updateGroup
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
group | Group to update | body | Group | required |
group_oid | The group_oid to update. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Insert a user on the UltraCart account.
SDK Function Name: insertUser
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
user | User to insert | body | User | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Delete a user on the UltraCart account.
SDK Function Name: deleteUser
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
user_id | The user_id to delete. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Retrieves a single user using the specified user id.
SDK Function Name: getUser
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
user_id | The user id to retrieve. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Update a user on the UltraCart account.
SDK Function Name: updateUser
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
user | User to update | body | User | required |
user_id | The user_id to update. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Retrieves logins for a single user using the specified user id.
SDK Function Name: getUserLogins
Parameter | Description | Location | Data Type | Required |
---|---|---|---|---|
user_id | The user id to retrieve. | path | integer (int32) | required |
// Internal API. User API has no value to merchants.
// (Internal API). No sample for this method as a merchant will never need call it.
// Internal API. No sample provided.
<?php
// The UserRestAPI is used internally by UltraCart for our own UI.
// We don't know of a use-case for merchants to use this API in their own automation,
// but it's a public part of our REST API.
//
// We're not including any examples for using the User Api, but if you find yourself needing it for some reason,
// contact us and we'll assist. But again, we doubt merchants will ever have a need for this API.
# Internal API - Please see the README.md in this directory for an explanation on why there are no samples here.
# Internal API. No samples are provided as merchants will never need this api method
// Internal API - no sample for this method.
Name | Data Type | Description |
---|---|---|
developer_message | string | A technical message meant to be read by a developer |
error_code | string | HTTP status code |
more_info | string | Additional information often a link to additional documentation |
object_id | string | Object id that the error is associated with |
user_message | string | An end-user friendly message suitable for display to the customer |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
group_oid | (read only) integer (int32) | The unique object identifier (oid for short) for this group |
name | string | The name of this group. |
notifications | array of Notification | A list of notifications the user receives. |
permissions | array of Permission | A list of permissions the user enjoys for accessing the backend of UltraCart. |
users | array of GroupUserMembership | A list of users that belong to this group. |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
group | Group | Group |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
groups | array of Group | |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
(read only) string | The email for this user. | |
fullName | string | The full name for this user. |
login | (read only) string | The login for this user. |
member | boolean | True if this user belongs to the parent group, false otherwise. |
user_id | (read only) integer (int32) | The user id for this user. |
Name | Data Type | Description |
---|---|---|
company | (read only) string | The company name of this linked account. |
merchant_id | (read only) string | A merchant id that is linked to this account. |
selected | boolean | If true, this user configuration (permissions, notifications, everything) is cascaded to this linked account. |
Name | Data Type | Description |
---|---|---|
can_filter_by_distribution_centers | (read only) boolean | True if this notification can be filtered to only send for one or more distribution centers. |
can_include_affiliate | (read only) boolean | True if this notification can include an affiliate information. |
can_include_order | (read only) boolean | True if this notification can include an order attachment. |
can_include_order_plain_text | (read only) boolean | True if this notification can include a plain text rendering of an order directly within an email. Some desire this over an attachment |
distribution_center_filters | array of string | If this notification supports it, this list of distribution center CODES will filter the notification to just those distribution centers. |
include_affiliate | boolean | If true, and this notification supports it, affiliate information will be attached to all notifications of this type |
include_order | boolean | If true, and this notification supports it, the order will be attached to all notifications of this type |
include_order_plain_text | boolean | If true, and this notification supports it, a plain text order will be directly inserted into all notifications of this type |
name | (read only) string | The name of this notification. |
notification_group | (read only) string | A group for this notification. This name is only used for visual grouping within interfaces. |
selected | boolean | True if this user wishes to receive this email notification. |
Name | Data Type | Description |
---|---|---|
permission_group | (read only) string | A group for this permission. This name is only used for visual grouping within interfaces. |
permission_Name | (read only) string | The name of this permission. |
selected | boolean | True if this user has this permission. |
Name | Data Type | Description |
---|---|---|
payload_name | string | Payload name |
result_set | ResultSet | Result set |
Name | Data Type | Description |
---|---|---|
count | integer (int32) | Number of results in this set |
limit | integer (int32) | Maximum number of results that can be returned in a set |
more | boolean | True if there are more results to query |
next_offset | integer (int32) | The next offset that you should query to retrieve more results |
offset | integer (int32) | Offset of this result set (zero based) |
total_records | integer (int32) | The total number of records in the result set. May be null if the number is not known and the client should continue iterating as long as more is true. |
Name | Data Type | Description |
---|---|---|
api_ip_address_masks | array of string | A list of IP addresses whitelisted for any user with API Access permission. Without this list, each ip address must be authenticated by a user, which can be a pain for some servers. |
change_ftp_password_to | string | Supply a new FTP password using this field. Password are stored using one-way encryption, so they are never available anywhere in the system. The FTP password cannot be the same as the normal password. |
change_password_to | string | Supply a new password using this field. Password are stored using one-way encryption, so they are never available anywhere in the system. |
string(150) | Email address of user | |
full_name | string | Full name of user. This is used solely for human assistance and so the UltraCart staff knows who they are calling when there is a problem. |
groups | array of UserGroupMembership | A list of groups for this merchant and whether or not this user is a member of those groups. |
linked_accounts | array of LinkedAccount | A list of linked accounts and whether or not this user is mirrored to any of those accounts. |
login | string | User name of user. Must be unique across a merchant account. |
login_histories | array of UserLogin | A list of user logins over the past 90 days |
notifications | array of Notification | A list of notifications the user receives. |
otp_serial_number | string | OTP Serial Number such as Google Authenticator or Crypto Card. |
permissions | array of Permission | A list of permissions the user enjoys for accessing the backend of UltraCart. |
phone | string | Phone number of user. Please supply a valid phone number. When something breaks on your account, we need to be able to reach you. |
user_id | (read only) integer (int32) | User id is a unique identifier for this user |
Name | Data Type | Description |
---|---|---|
group_oid | (read only) integer (int32) | The unique object identifier (oid for short) for this group |
member | boolean | True if this user is a member of the group. |
name | string | The name of this group. |
Name | Data Type | Description |
---|---|---|
ip_address | (read only) string | IP Address |
login | (read only) string | login |
login_dts | (read only) string (dateTime) | Login date/time |
user_agent | (read only) string | User Agent |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
logins | array of UserLogin | Logins |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
user | User | User |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
error | Error | Error object if unsuccessful |
metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
success | boolean | Indicates if API call was successful |
users | array of User | |
warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
Name | Data Type | Description |
---|---|---|
more_info | string | Additional information often a link to additional documentation |
warning_message | string | A technical message meant to be read by a developer |
Name | Data Type | Description |
---|---|---|
UC-REST-ERROR | string | Contains human readable error message |
Name | Data Type |
---|---|
body | ErrorResponse |
Name | Data Type | Description |
---|---|---|
UC-REST-ERROR | string | Contains human readable error message |
Name | Data Type |
---|---|
body | ErrorResponse |
Name | Data Type | Description |
---|---|---|
UC-REST-ERROR | string | Contains human readable error message |
Name | Data Type |
---|---|
body | ErrorResponse |
Name | Data Type | Description |
---|---|---|
UC-REST-ERROR | string | Contains human readable error message |
Name | Data Type |
---|---|
body | ErrorResponse |
Name | Data Type | Description |
---|---|---|
UC-REST-ERROR | string | Contains human readable error message |
Name | Data Type |
---|---|
body | ErrorResponse |