Add or Update a Contact Person
Query String Parameters
Name | Type | Description | Required |
---|---|---|---|
Action | String | ContactSavePerson | Required |
ContactId | String | The unique identifier of the contact which can be retrieved using Contact List. | Required |
ContactRef | String | The internal reference of the contact. | Required |
String | Email address. | Required | |
UserId | String | User Id. | Optional |
MainUser | Bool | Mark as main user. | Optional |
FirstName | String | First name. | Optional |
LastName | String | Last name. | Optional |
Title | String | Title. | Optional |
Position | String | Position. | Optional |
Department | String | Department. | Optional |
Phone | String | Mobile phone number. | Optional |
Landline | String | Landline number. | Optional |
LandlineExtension | String | Landline extension. | Optional |
NoMarketing | Bool | Mark as 'No Marketing' | Optional |
IgnoreEmailValidation | Bool | Ignore email validation. | Optional |
TagId | Int | Id of tag to set on person. | Optional |
Response Codes
Code | Message | Information |
---|---|---|
0 | Response Data | See 'Response' example tab |
2 | Email parameter required | Mandatory parameter was not supplied |
2 | contactId or contactRef parameters required | Mandatory parameter was not supplied |
2 | invalid parameter - contactId | Integer value is invalid or was not specified (when required) |
2 | No matching contact | No record found using the specified parameters |
2 | misc_noRight | You do not have the permissions to view contacts. |
Example
- Request
- Response
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
Response Data
{ "Code": 0, "Result": "10c76b0c-9ee4-47c4-87f4-0dabf121c030" }