Contact identified event

Triggered when Mautic identifies a Contact.

Event type

mautic.lead_post_save_new

Event properties

Key	Type	Description
contact	object	Contact object
timestamp	string	Date/time the event occurred in ISO 8601 format.

Contact properties

Key	Type	Description
id	int	ID of the Contact
isPublished	boolean	Always true.
dateAdded	string	Date/time of Contact creation in ISO 8601 format.
createdBy	int|null	The ID of the User who created the Contact or null if unknown. For example, visitor tracking.
createdByUser	string|null	Name of the User that created the Contact if applicable. Otherwise null.
dateIdentified	string|null	Date/time of Contact identification in ISO 8601 format or null if it’s a visitor.
dateModified	string|null	Date/time the Contact was last modified in ISO 8601 format or null if not modified.
modifiedBy	int|null	The ID of the User who last modified the Contact or null if unknown. For example, visitor tracking.
modifiedByUser	string|null	Name of the User that last modified the Contact if applicable. Otherwise null.
points	int	The Contact’s Points, also known as a Behavior Score.
color	string|null	Hex code for the Point Trigger color configured for the range of Points the Contact currently has.
preferredProfileImage	string	Preferred image to display for the Contact. Defaults to gravatar.
fields	object|array	Mautic groups fields by Field Groups keyed as one of core, social, personal, and professional. Each fieldGroup has an object of Fields keyed by the Field’s API name. See Custom Field object for each Field’s properties. Note that this could be an object if there are Fields available. Otherwise, Mautic sets an empty array. For example, $firstname = $contact['fields']['core']['firstname']['value'];.
lastActive	string|null	Date/time the Contact was last active in ISO 8601 format or null if it hasn’t been active.
owner	object|null	User object or null if no Owner assigned.
ipAddresses	object	IP Address object.
tags	object	Tag object.
doNotContact	array of objects	Array of Channel subscription objects.
frequencyRules	array	Currently not populated for Webhooks.
utmtags	array	Currently not populated for Webhooks.
stage	object	Currently not fully populated for Webhooks.

Custom Field properties

Key	Type	Description
id	int	ID of the Field.
group	string	The group the Field belongs to. Current options are core, social, personal and professional.
label	string	Label for the Field.
alias	string	API name for the Field.
type	string	Field type. Current options are boolean, date, datetime, email, country, locale, number, tel, region, select, multiselect, text, textarea, time, timezone, and url.
properties	object	Properties for the given Field type. This varies based on the Field’s configuration.
value	mixed	Field’s value for the Contact.
normalizedValue	mixed	Field’s normalized value for the Contact.

Owner properties

Key	Type	Description
id	int	User’s ID.
username	string	User’s username.
firstname	string	User’s first name or given name.
lastname	string	User’s last name or surname.

IP Address properties

Key	Type	Description
id	int	IP Address’ ID.
ipAddress	string	IP Address.
ipDetails	object	Details of the IP Address such as city, region, latitude, longitude, etc.
ipDetails.city	string	City location of IP.
ipDetails.region	string	Region location of IP.
ipDetails.zipcode	string	Zip code location of IP.
ipDetails.latitude	string	Latitude location of IP.
ipDetails.longitude	string	Longitude location of IP.
ipDetails.isp	string	ISP that owns the IP.
ipDetails.organization	string	Organization assigned to the IP.
ipDetails.timezone	string	Timezone the IP location belongs to.
ipDetails.extra	mixed	Stores extra data given by the configured IP lookup service.

Tag properties

Key	Type	Description
id	int	ID of the Tag.
tag	string	Tag name.

Channel subscription properties

Key	Type	Description
id	int	ID of the Channel subscription entry.
reason	int	Reason code for the unsubscription. 1 reflects unsubscribed by the Contact, 2 reflects bounced, and 3 is manually marked as unsubscribed by the Marketer.
channel	string	Channel the Contact unsubscribed from. Examples are email and sms.
channelId	int|null	ID of the specific Channel entity the Contact clicked to unsubscribe from.