Description

The Contact API allows carrier customers to sync 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	Create Contact
Service Type	REST
Method	POST
UAT (Sandbox) URL	https://integration.uat.marley.ai/api/contacts
Production URL	https://integration.himarley.io/api/contacts
Technical Documentation	View technical documentation with sample request and response payloads hosted on Postman.

API Request

Request Example

{
    "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	true	"first": "Test"
last	The surname for the Contact.	string	true	"last": "Name"
mobile	The mobile number for the Contact.	string	true	"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-09-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"