pem.addAccountMember

This method is supported by Operations starting from version 2.3

This method creates a Staff Member in Operations.

There are the following use cases:

Operations stores Account's and Staff Member's properties in the system database, and Operations authenticates Staff Member by itself. In this case the auth, person, address, phone, fax, and email parameters are mandatory. The external_identity parameter should not be specified.
Account's and Staff Member's properties are stored in the External System, and External System is used for Staff Members authentication purposes. In this case the external_identity parameter is mandatory. The auth, person, address, phone, fax, and email parameters should not be specified.

The method has the following input parameters:

Name	Type	Short Description
`account_id`	int	ID of Account.
`[subscription_id]`	int	ID of Subscription, which provides the Additional Staff Members Resource Type. This is an optional parameter. There are the following use cases: The parameter is specified. In this case Operations uses the Additional Staff Members Resource Type from the Subscription specified. The parameter is not specified. In this case Operations looks at all Account's Subscriptions and searches the least loaded Additional Staff Members Resource. Note: If an Account has no Staff Members yet, then the Staff Member creation will succeed in any case. Important: Starting from Operations 5.5 this parameter is ignored.
`[user_id]`	int	ID of Staff Member. This is an optional parameter. If parameter is not specified, Operations generates `user_id` itself.
`[login]`	string	Key of Staff Member in the External System, which is associated with Account (an external account is required). This parameter is optional. It is used if Account's and Staff Member's properties are stored in the External System, and External System is used for Staff Member authentication purposes. Important: Since Operations 2.9, this parameter is deprecated. The `external_identity` parameter should be used instead.
`[external_identity]`	struct	Identity of Staff Member in the External System. This is an optional parameter. It should be used if Staff Member belongs to the External System.
`system_name`	string	External System name.
`identity_key`	string	External key that is passed to the External System for identification of the Staff Member. The external key is static unique key in the scope of specified External System. The format of the key depends on External System plug-in implementation and External System configuration. To obtain information about this parameter, refer to the plug-in documentation.
`[auth]`	struct	It contains information, which is used for authenticating the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`login`	string	Login of Staff Member.
`password`	string	Password of Staff Member.
`[check_password]`	boolean	It defines whether to check the quality of the password, against the password quality level defined in Operations.
`[person]`	struct	It contains general information about the person represented by the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`[title]`	string	Title of the person represented by the Staff Member. For example: Mr. or Mrs., etc.
`first_name`	string	The first name of the person represented by the Staff Member.
`[middle_name]`	string	The middle name of the person represented by the Staff Member.
`last_name`	string	The last name of the person represented by the Staff Member.
`[company_name]`	string	The name of the company represented by the Staff Member.
`[address]`	struct	It contains address information for the person represented by the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`street_name`	string	Name of the street.
`[house_num]`	string	The number of the house.
`[address2]`	string	Second address.
`zipcode`	string	Postal code.
`city`	string	Name of the city.
`country`	string	This is the code of the country represented by two lowercased letters, like the us, uk, etc.
`state`	string	Name of the state/province.
`[phone]`	struct	It contains phone information for the person represented by the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`country_code`	string	Country code part of the phone number.
`area_code`	string	Area code part of the phone number.
`phone_num`	string	The phone number itself.
`ext_num`	string	Extension to the phone number, if present.
`[fax]`	struct	It contains fax information for the person represented by the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`country_code`	string	Country code part of the fax number.
`area_code`	string	Area code part of the fax number.
`phone_num`	string	The fax number itself.
`ext_num`	string	Extension to the fax number, if present.
`[email]`	string	The e-mail address of the person represented by the Staff Member. This is an optional parameter. It should be used, if Staff Member belongs to Operations.
`[roles]`	array of string	Names of Roles. If the parameter is specified, Operations grants the Roles to Staff Member. Note: The first Account's Staff Member automatically obtains the Account Administrator Role, the subsequent Account's Staff Members automatically obtain the Staff member defaults Role.

The method has the following output parameters:

Name	Type	Short Description
`user_id`	int	Staff Member ID

For XML-RPC sample of using this method see pem.addAccountMember Sample section in XML-RPC Samples appendix.