Add a Contact Parent
Link a Contact (child) to another Contact (parent). Both contacts must already exist to be able to use this webservice.
Query String Parameters
Name | Type | Description | Required |
---|---|---|---|
Action | String | ContactParentLink | Required |
ContactId | Int | The unique identifier of the contact which can be retrieved using Contact List. | Required |
ContactParentId | Int | The unique identifier of the parent contact which can be retrieved using Contact List. | Required |
OverwriteIfExists | Bool | If the contact already has a parent contact – setting this to true will override the original parent contact. | Required |
Response Codes
Code | Message | Information |
---|---|---|
0 | Contact {contact.ContactName} is already linked to a parent contact: {contactParent.ContactName}. | Contact is already linked. Message includes the Contact Names for reference |
0 | Parent Contact: {contactParent.ContactName} has been linked to Contact Record: {contact.ContactName}. | Contact has been linked successfully. Message includes the Contact Names for reference |
2 | contactNoteId, contactNoteParentId or overwriteIfExists parameters required | Mandatory parameter was not supplied |
2 | Overwriteifexists requires value true or false | Boolean value is invalid or was not specified (when required) |
2 | Invalid contact id | Integer value is invalid or was not specified (when required) |
2 | No matching contact record | No data returned or set-up in BigChange |
2 | No matching parent record | No data returned or set-up in BigChange |
2 | misc_noRight | You do not have the permissions to create and update contacts. |
Example
- Request
- Response
Request URL
https://webservice.bigchange.com/v01/services.ashx??action=ContactParentLink&ContactId=27095183&ContactParentId=27095154&OverwriteIfExists=false
Response Data
{ "Code": 0, "Result": "Parent Contact: Joe Bloggs has been linked to Contact Record: Fred Smith." }