Description

The Update Contact API allows carrier customers to sync & update contacts from their claims or policy systems directly into Hi Marley.

It enables seamless search and case creation for contacts, improving operational efficiency and customer interactions.

Service Name	Update Contact
Service Type	REST
Method	PATCH
UAT (Sandbox) URL	https://integration.uat.marley.ai/api/contacts/:contactId
Production URL	https://integration.himarley.io/api/contacts/:contactId
Technical Documentation	View technical documentation with sample request and response payloads hosted on Postman.

API Request

Request Example

Only pass through the property you wish to update on the Contact correlating to the contactId passed.

https://integration.uat.marley.ai/api/contacts/154024a9-08ae-4d08-880f-dfd4c6a6df1b

{
    "first": "Test",
    "last": "Name",
    "mobile": "+14012744005",
    "languagePreference": "en",
    "email": "test-email@himarley.com"
}

Request Field Breakdown

Property	Description	Type	Required	Example	Validation
first	The given name for the Contact.	string	false	"first": "Test"
last	The surname for the Contact.	string	false	"last": "Name"
mobile	The mobile number for the Contact.	string	false	"mobile": "+14012744005"
languagePreference	The language preference for the Contact.	enum	false	"languagePreference": "en"
email	The email for the contact.	string	false	"email": "test-email@himarley.com"

Response Payload Example

{
    "id": "463d5a15-655d-49dd-b698-cdaa1b7c5518",
    "first": "Test",
    "last": "Name",
    "mobile": "+15552084210",
    "optStatus": "PENDING_OPT_IN",
    "languagePreference": "en",
    "updatedAt": "2024-10-06T18:18:22.774Z",
    "createdAt": "2024-09-06T18:18:22.774Z",
    "email": "test-email@himarley.com"
}

Response Fields Breakdown

Property	Description	Type	Required	Example
id	The Hi Marley UUID generated for the Contact upon creation.	string UUID	true	"id": "0e2261fe-e05e-4049-b9d6-505a32272d42"
first	The given name for the Contact.	string	true	"first": "test"
last	The surname for the Contact.	string	true	"last": "name"
mobile	The mobile number for the Contact.	string	false	"mobile": "15552084238"
optStatus	The Contacts Opt Status.	enum	false	"optStatus": "OPTED_IN"
languagePreference	The language preference for the Contact.	enum	false	"languagePreference": "en"
updatedAt	The time stamp for when the Contact is updated.	dateTime	true	"updatedAt": "2024-07-15T15:41:54.684Z"
createdAt	The time tamp for when the Contact is created	dateTime	true	"createdAt": "2024-07-15T15:41:54.684Z"
email	The email for the Contact	email	false	"email": "test-email@himarley.com"