Update B2B Account Status

put https://t{tenantId}-s{siteId}.{env}.mozu.com/api/commerce/customer/b2baccounts/{accountId}/status/{actionName}

Updates the status on B2B account by transitioning it between states with the approve, deny, enable, and disable actions. An account that has been newly requested will be in the Pending Approval state and can be approved or denied. An account that has been previously approved can be disabled to deactivate it, while a disabled or denied account can be reinstated by enabling or approving it.

Response

Response body

object

users

array of objects | null

List of B2B users on the account.

users

object

emailAddress

string | null

userName

string | null

firstName

string | null

lastName

string | null

localeCode

string | null

userId

string | null

Unique identifier of the user who is currently logged in. This is null if the user is anonymous (not logged in). Unicode data with a maximum length of 55 characters.

roles

array of objects | null

roles

object

userId

string | null

assignedInScope

object

roleId

int32

roleName

string | null

roleResources

array of objects | null

roleResources

object

type

string | null

roleTags

array of strings | null

roleTags

auditInfo

object

isLocked

boolean

isActive

boolean

isRemoved

boolean

acceptsMarketing

boolean

If true, the customer prefers to receive marketing material such as newsletters or email offers.

hasExternalPassword

boolean

Indicates if an external password is set on this account

isActive

boolean | null

Is the B2B account active?

priceList

string | null

Price list on B2B account.

salesReps

array of objects | null

List of sales rep on B2B account.

salesReps

object

accountId

int32

adminUserId

string | null

rootAccountId

int32 | null

Root account Id in B2B hierarchy

parentAccountId

int32 | null

Parent account Id in B2B hierarchy

approvalStatus

string | null

Status on B2B account.

int32

Unique identifier of the account, also known as a customer number.

customerSet

string | null

commerceSummary

object

Commerce (orders and wishlists) on a customer account which lists all the orders the customer has made with the order date, order amount, and status. Includes cancellations and returns. Also includes wishlist information.

totalOrderAmount

object

The currency code and amount of an order listed in the order history of a customer account. Currently, only USD is supported.

orderCount

int32

Number of orders listed in the order history of a customer account.

lastOrderDate

date-time | null

When the last order was placed.

wishlistCount

int32

Number of wishlists listed in the wishlist count of a customer account

visitsCount

int32

Number of visits for this customer across the entire tenant.

contacts

array of objects | null

List of contacts for this account. A customer account can have multiple contacts for billing and shipping addresses.

contacts

object

accountId

int32

types

array of objects | null

types

object

name

string | null

isPrimary

boolean

auditInfo

object

faxNumber

string | null

label

string | null

int32 | null

string | null

firstName

string | null

middleNameOrInitial

string | null

lastNameOrSurname

string | null

companyOrOrganization

string | null

phoneNumbers

object

address

object

companyOrOrganization

string | null

The company or organization name for an account.

notes

array of objects | null

List of notes for the account. Merchants use these internal notes, for example, to make a note of a customer's interests or complaints.
Notes are available only from the merchant's view, customers cannot view these notes.

notes

object

int32

Unique identifier of the note.

content

string | null

Content of the note that the merchant added.

auditInfo

object

attributes

array of objects | null

List of attributes for the account.

attributes

object

auditInfo

object

fullyQualifiedName

string | null

attributeDefinitionId

int32 | null

values

array | null

values

segments

array of objects | null

List of segments assigned to account. Merchants create segments, for example, to manage discounts or assign VIP status.
Then they assign the account to the segment. An account can belong to several segments or none at all.

segments

object

int32

Unique identifier of the customer segment.

code

string | null

Unique identifier of the customer segment.

name

string | null

Name of the customer segment.

description

string | null

Description of the customer segment.

auditInfo

object

taxExempt

boolean

taxId

string | null

externalId

string | null

auditInfo

object

updateDate

date-time | null

createDate

date-time | null

updateBy

string | null

createBy

string | null

customerSinceDate

date-time | null

Date when the customer account is created.

accountType

string | null

Type of account.

migrationRequired

boolean

Indicates Subscription migration is required or not.

Language

Credentials

Bearer

JWT

URL


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://t0-s0.sandbox.mozu.com/api/commerce/customer/b2baccounts/accountId/status/actionName \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/json

text/plain

200Success