Creating a security role
To create a security role, you assign the role a name, then update it by choosing a parent or child role, and setting privileges.
<SOAP-ENV:Body>
<Administrate>
<AdminOperation>
<Transaction>
<TransactionOperation>
<CreateRole>
<Role>
<Name>Field Sales</Name>
</Role>
<IgnoreDup>false</IgnoreDup>
</CreateRole>
<UpdateRole>
<SetParentRolesByName>
<String>Sales Representatives</String>
</SetParentRolesByName>
<NameList>
<Name>Field Sales</Name>
</NameList>
</UpdateRole>
</TransactionOperation>
</Transaction>
</AdminOperation>
</Administrate>
</SOAP-ENV:Body>
The response to a successful CreateRole request is an empty Administrate response. If the request fails, an error message appears.