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.

Change Log

10/08/2015

  1. New documentation.

Getting Started

REST APIs

Resources