Smartstaff
1,385
edits
Changes
no edit summary
--End custom parameter--
''Note:''
1. As per May 2019 upgrade, use ''objectid'' but ''recordid'' still works.
2. In '''Field List''', either use organizations or companies. If organizations is used in the '''Field List''', '''type''' in the parameter should be organizations.
[[File:APIFunctionSample5k.PNG|800px]]
====Update Associations====
Update function for association can add new association records or update the role of an existing association record.<br />
A. When this function is used to add new record, the following parameters are mandatory: objectid, companyid or contactid, rolename or roleid.<br />
B. When this function is used to update existing association records, it can only update the role of existing association records. Mandatory parameters are objectid, companyid or contactid, rolename or roleid and associationid. When the existing record is updated to a new role, all custom fields of the association from the previous role will be deleted.<br />
If you need to change company/contact, the record will need to be deleted and then add a new record for a new association.
=====Create/Update contact associations of a Level 1=====
'''Function Name''' - 3.05.3.1 Update Associations Method Sample 1: update contact associations of an existing Level 1<br />
rolename / roleid - association role of the user
isupdate - "1" for yes to update and "0" for to add new record <br/>
Parameter OptionSample#1<br />
--Begin custom parameter --<br />
jsonrset : [{"objectid":"10697883","contacts":[{"contactid":"3108577","rolename":"Meeting Participant","isupdate":"0"}]}] <br />
--End custom parameter--
Parameter OptionSample#2 - Starting May 2019 Upgrade<br />
--Begin custom parameter --<br />
jsonrset : [{"objectid":"10697883","contacts":[{"contactid":"3108577","rolename":"Signee Internal"}]}] <br />
--End custom parameter--
Parameter OptionSample#3 - adding multiple contacts sample<br />
--Begin custom parameter --<br />
jsonrset : [{"objectid":"10697883","contacts":[{"contactid":"3108226","rolename":"Signee Internal"},{"contactid":"3108119","rolename":"Meeting Participant"}]}] <br />
