Depending on applicable regulations or business limitations, specific API requests may not be available for your use.

Create Account Permission

Description

This request is to grant member permission on the account.

Request URL

Syntax	POST /restapi/accounts/{accountnumber}/permissions
Example URL	https://api.uat.foliofn.com/restapi/accounts/RA1234ABCD/permissions

Request Data Fields

Field	Type	Description	Required	Value
loginId	String	A unique ID for the member who is going to be granted permission on the account.	Yes
accountNumber	String	A unique ID for the account on which the permission will be granted.	No. If null, use the accountnumber specified on the URI.
permission	String	The level of the permission the member will be granted on the account.	Yes	See Permission Level. Note that one type of preexisting permission level, ‘AC’ on the account cannot be granted, modified or revoked.
alertLevel	String	The level of the alert communication the member will have on the account.	Yes	‘all’ – All Alerts ‘limited’ – Statements and Confirms only ‘none’ – No alerts Note that a member having ‘AM’ level permission on the account must also have ‘all’ alert communication level.
listOnReport	Boolean	The indicator of whether the member will be listed on the different reports.	Yes

Request Example


POST /restapi/accounts/RA1234ABCD/permissions
Content-Type: application/json
{
    "accountNumber":"RA1234ABCD",
    "alertLevel":"all",
    "listOnReport":false,
    "loginId":" testusername2",
    "permission":"MM"
}

Response Example


HTTP/1.1 201 Created
Location: https://api.uat.foliofn.com/restapi/accounts/RA8087900Z/permissions/testusername2
Content-Length: 0
Link:
<https://api.uat.foliofn.com/restapi/accounts/RA8087900Z/permissions/testusername2>; rel="DELETE"; type="application/json"; title="deletePermission",
<https://api.uat.foliofn.com/restapi/accounts/RA8087900Z/permissions/testusername2>; rel="PUT"; type="application/json"; title="modifyPermission",
<https://api.uat.foliofn.com/restapi/accounts/RA8087900Z/permissions/testusername2>; rel="GET"; type="application/json"; title="getPermission"

Error Codes

HTTP Code Status	Field	Code	Message	Description
400	-	account.permission.watch.member.lowest.level.rule	-	Any unverified member cannot be granted a permission higher than 'Detail Viewer' level
400	-	account.manager.alert.level.rule	-	A member is going to be granted as 'Account Manager', but has not 'all' alert communication level.
400	-	account.permission.for.account.creator.rule	-	The permission setup of an 'Account Creator' cannot be granted, modified or revoked.
400	-	account.permission.existence.rule	-	The member already has permission setup on the account.
400	-	only.advisor.can.list.on.report.rule	-	Only advisor member can be listed on the report.