Skip to main content

Add or Update a Contact Person

Query String Parameters

NameTypeDescriptionRequired
ActionStringContactSavePersonRequired
ContactIdStringThe unique identifier of the contact which can be retrieved using Contact List.Required
ContactRefStringThe internal reference of the contact.Required
EmailStringEmail address.Required
UserIdStringUser Id.Optional
MainUserBoolMark as main user.Optional
FirstNameStringFirst name.Optional
LastNameStringLast name.Optional
TitleStringTitle.Optional
PositionStringPosition.Optional
DepartmentStringDepartment.Optional
PhoneStringMobile phone number.Optional
LandlineStringLandline number.Optional
LandlineExtensionStringLandline extension.Optional
NoMarketingBoolMark as 'No Marketing'Optional
IgnoreEmailValidationBoolIgnore email validation.Optional
TagIdIntId of tag to set on person.Optional

Response Codes

CodeMessageInformation
0Response DataSee 'Response' example tab
2Email parameter requiredMandatory parameter was not supplied
2contactId or contactRef parameters requiredMandatory parameter was not supplied
2invalid parameter - contactIdInteger value is invalid or was not specified (when required)
2No matching contactNo record found using the specified parameters
2misc_noRightYou do not have the permissions to view contacts.

Example

Request URL

https://webservice.bigchange.com/v01/services.ashx?action=ContactSavePerson&ContactId=30966833&Email=JoeBloggs@email.com&MainUser=1&FirstName=Joe&LastName=Bloggs&Title=Mr