Update account

X-Api-Token

header

string

Required

API token of a manager that performs the operation (see

)

Content-Type

header

string

Required

Media type of the request. Specify the following: application/vnd.api+json

Accept

header

string

Required

Supported media types of the answer. Specify the following: application/vnd.api+json

base_url

path

string

Required

ActivePlatform URL

reseller_id

path

integer

Required

ID of the current reseller or any of its downstream resellers (see 

)

account_id

path

integer

Required

Account ID

data

form

object

Required

Information about the attributes of the operation

attributes

form

object

Required

Attributes of the operation

account_type_id

form

integer

Required

Account type ID (see

)

primary_name

form

string

Optional

Primary name of the account (for example, a company name, if the customer is a legal entity)

first_name

form

string

Optional

The first name of the contract person

middle_name

form

string

Optional

The middle name of the contract person

last_name

form

string

Optional

The last name of the contract person

email

form

string

Optional

The email of the contract person

manager_id

form

integer

Optional

ID of the manager that will be linked to the account

account_class_key

form

string

Optional

Account class key (see )

tech_user_id

form

integer

Optional

ID of the user referred to as the Tech contact

bill_user_id

form

integer

Optional

ID of the user referred to as the Billing contact

country

form

string

Optional

Contact information: a two-letter ISO code of the country ISO 3166-1 alpha-2

region

form

string

Optional

Contact information: Region

city

form

string

Optional

Contact information: City

street

form

string

Optional

Contact information: Street

building

form

string

Optional

Contact information: Building

office

form

string

Optional

Contact information: Office

zip

form

string

Optional

Contact information: Zip-code

phone

form

string

Optional

Contact information: Phone number:

• + < country code > < city code or network code > < phone number >.

• 00 < country code > < city code or network code > < phone number >.

financial_blocking_threshold_use_system

form

bool

Optional

Defines whether the account uses the default financial blocking threshold value that is set in the account class:

• true — the account uses the financial blocking threshold value that is set in the account class.

• false — the account uses the financial blocking threshold value that is redefined on the account level.

financial_blocking_threshold

form

float

Optional

The value of the financial blocking threshold for the account that is redefined on the account level.

Required if financial_blocking_threshold_use_system = false

subscription_credit_limit_use_system

form

bool

Optional

Defines whether the account uses the default subscription credit limit value that is set in the account class:

• true — the account uses the subscription credit limit value that is set in the account class.

• false — the account uses the subscription credit limit value that is redefined on the account level.

subscription_credit_limit

form

float

Optional

The value of the subscription credit limit for the account that is redefined on the account level.

Required if subscription_credit_limit_use_system = false

account_product_managers

form

object

Optional

Responsible managers of the account (see

)

data

form

array

Optional

Information about responsible managers of the account

product_id

form

integer

Optional

Product ID

manager_product_role_id

form

integer

Optional

Manager role ID within the product

responsible_product_manager_id

form

integer

Optional

Responsible manager ID within the product

custom_attributes

form

object

Optional

The additional attributes of the account

data

form

array

Optional

Information about the additional attributes of the account (see )

key

form

string

Optional

The key of the additional attribute of the account

value

form

string

Optional

The value of the additional attribute of the account.

Depending on the value type, the value is specified in the following formats:

• Checkbox:1 for true.0 for false.

• Date: DD.MM.YYYY.

• List: Key of the element.

422

Manager to attach must be a 'sales person' and be in 'active' status

If it is necessary to attach a manager to the account, specify the ID of a manager that has the Sales person role and the Active status (see

)

Available options: <list of countries>

The reseller limited the list of countries available for creating a new account. See the Region settings section in

.

Account must have subscription on product to assign responsible product manager

If it is necessary to attach a responsible manager to an account, specify the following data:

1. ID of a product linked to a confirmed Sales Order of the account (see Get list of orders).

2. ID of a manager role existing within the specified product (see ).

3. ID of a user assigned to the specified product as a responsible manager with the specified manager role (see ).

Such role is not configured in product

Manager with id is not responsible product manager

All validation errors for the account attributes are displayed similar to the Operator Control Panel (see 

in 

)