User Details Update

Event Key

ootb_user_details_update

This event should be sent when a user updates their profile or registration details (e.g., email, preferences, personal info).

Event KeyEvent NameType
ootb_user_details_updateUser Details UpdateSimple event
⚠️

Note: Real-Time Attribute Sync This event serves a dual purpose: it tracks the user's activity and automatically updates the Customer Attributes (Customer Data) in real time. Any values passed in this event will overwrite existing data in the customer profile.

Event Structure

The mandatory properties (tenant, timestamp, event, and customer) are required for all events and documented in detail on the Mandatory Properties page. Below is the JSON structure for the context-specific properties of the Update Customer Details event:

{
  "context": {
    "ootb_email": "[email protected]",
    "ootb_mobile_number": "+1234567890",
    "ootb_status":"Started" /  "Completed",
    "ootb_registration_source": "product page",
    "ootb_date_of_birth": "1990-01-15",
    "ootb_allow_email": "Yes",
    "ootb_allow_sms": "Yes",
    "ootb_allow_push": "Yes",
    "ootb_allow_whatsapp": "Yes",
    "ootb_is_email_verified": true,
    "ootb_is_mobile_verified": true,
    "ootb_is_blocked": false,
    "ootb_is_test": false,
    "ootb_gender": "male",
    "ootb_country": "US",
    "ootb_city": "NYC",
    "ootb_address": "Street 1111",
    "ootb_first_name": "John",
    "ootb_last_name": "Doe",
    "ootb_language": "en",
    "ootb_currency": "USD",
    "ootb_brand": "",
    "ootb_alias": "johndoe90",
    "ootb_referral_type": "Advertising",
    "ootb_affiliate_id": "",
    "ootb_platform": "iOS",
    "ootb_promo_code": "WELCOME2024",
    "ootb_license": "licenseXYZ"
  }
}

Parameters

📘

Events-based Integration (EBI): parameter classification

The Events-based Integration column shows how each parameter is treated when you onboard using an Events-based Integration:

  • Mandatory — required for the event to be ingested and processed correctly.
  • Mandatory if required for the execution channel integration — required only when the relevant execution channel (e.g., email, SMS, push, WhatsApp) is part of your integration.
  • Enrichment- used for out-of-the-box attribute — not required, but when provided it powers an Optimove out-of-the-box attribute.
  • Optional — accepted and stored when provided; not required and not tied to an OOTB attribute.
Parameter KeyTypeDescriptionEvents-based Integration
ootb_emailStringThe customer's email address.Mandatory if required for the execution channel integration
ootb_mobile_numberStringThe customer's mobile phone number.Mandatory if required for the execution channel integration
ootb_statusStringRegistration status: Started, Completed, or Failed.Optional
ootb_registration_sourceStringWhere registration was initiated (e.g., product page, checkout, header).Optional
ootb_date_of_birthStringThe customer's date of birth in ISO format (YYYY-MM-DD).Enrichment- used for out-of-the-box attribute
ootb_allow_emailStringConsent to email notifications (Yes/No).Mandatory if required for the execution channel integration
ootb_allow_smsStringConsent to SMS notifications (Yes/No).Mandatory if required for the execution channel integration
ootb_allow_pushStringConsent to push notifications (Yes/No).Mandatory if required for the execution channel integration
ootb_allow_whatsappStringConsent to WhatsApp notifications (Yes/No).Mandatory if required for the execution channel integration
ootb_is_email_verifiedBooleanWhether email is verified (true/false).Enrichment- used for out-of-the-box attribute
ootb_is_mobile_verifiedBooleanWhether mobile number is verified (true/false).Enrichment- used for out-of-the-box attribute
ootb_is_blockedBooleanCustomer blocked status (true/false).Enrichment- used for out-of-the-box attribute
ootb_is_testBooleanTest account flag (true/false).Enrichment- used for out-of-the-box attribute
ootb_genderStringCustomer gender (e.g., male, female, other).Enrichment- used for out-of-the-box attribute
ootb_countryStringCountry code (e.g., US, UK).Enrichment- used for out-of-the-box attribute
ootb_cityStringCustomer’s city.Enrichment- used for out-of-the-box attribute
ootb_addressStringCustomer’s address.Enrichment- used for out-of-the-box attribute
ootb_first_nameStringCustomer’s first name.Enrichment- used for out-of-the-box attribute
ootb_last_nameStringCustomer’s last name.Enrichment- used for out-of-the-box attribute
ootb_languageStringCustomer’s language preference (e.g., en, fr).Enrichment- used for out-of-the-box attribute
ootb_currencyStringCustomer’s preferred currency code.Enrichment- used for out-of-the-box attribute
ootb_brandStringBrand identifier (optional—for gaming platforms).Enrichment- used for out-of-the-box attribute
ootb_aliasStringGaming alias or username.Enrichment- used for out-of-the-box attribute
ootb_referral_typeStringHow the user was referred (e.g., SEO, Affiliate, Advertising).Enrichment- used for out-of-the-box attribute
ootb_affiliate_idStringAffiliate identifier or name.Optional
ootb_platformStringPlatform used during registration (e.g., iOS, Android, Web).Enrichment- used for out-of-the-box attribute
ootb_promo_codeStringPromotional code applied during registration.Optional
ootb_licenseStringLicense or regulation identifier.Optional