Contact resource

Methods

  • get - Get contact (deprecated)
  • get - Get contact detail by email
  • get - Get contact detail by externalId
  • patch - Patch contact (deprecated)
  • patch - Patch contact by email
  • patch - Patch contact by externalId

Resource

{
    "<key>": "string",
    "_androidAppVersion": "string",
    "_androidLastActivityDate": "date-time",
    "_androidOsVersion": "string",
    "_androidSdkVersion": "string",
    "_averagePurchasesAmount": "number",
    "_birthdate": "date-time",
    "_churnRate": "number",
    "_clv": "number",
    "_createdAt": "date-time",
    "_email": "email",
    "_emailBouncedReason": "string",
    "_emailLastBouncedDate": "date-time",
    "_emailLastSoftBounceDate": "date-time",
    "_emailLastUnsubscribedDate": "date-time",
    "_emailLastUnsubscribedIp": "ip",
    "_emailSoftBounces": "integer",
    "_emailStatus": "string",
    "_expectedPurchases": "number",
    "_firstPurchaseDate": "date-time",
    "_frequency": "string",
    "_hasPushSubscriptions": "boolean",
    "_iosAppVersion": "string",
    "_iosLastActivityDate": "date-time",
    "_iosOsVersion": "string",
    "_iosSdkVersion": "string",
    "_isAnonymous": "boolean",
    "_lastPurchaseDate": "date-time",
    "_mobilePhone": "international",
    "_mobilePhoneStatus": "string",
    "_monetary": "string",
    "_name": "string",
    "_newsletterSubscriptionStatus": "string",
    "_pAlive": "number",
    "_points": "integer",
    "_recency": "string",
    "_rfm": "string",
    "_smsSubscriptionStatus": "string",
    "_surname": "string",
    "_totalPurchases": "integer",
    "_totalPurchasesAmount": "number",
    "_updatedAt": "date-time",
    "_usesMobileApp": "boolean",
    "id": "string"
}

Properties

Name Type Description Additional
<key> map of string

A custom field created in Connectif. The key must be the custom field id and the value must be of the appropiate type: string for 'text', 'email', 'date', 'radio' and 'phone' fields; boolean for 'boolean' fields; number for 'decimal' fields; 'integer' for integer fields and an array of string for 'checkbox' fields.

 Optional
_androidAppVersion string

The version of the mobile app in Android (only if mobile app integration is enabled).

 Optional
_androidLastActivityDate date-time

The date of the last activity of the contact in the mobile app in Android, in ISO8601 format (only if mobile app integration is enabled).

 Optional
_androidOsVersion string

The version of the Android operating system (only if mobile app integration is enabled).

 Optional
_androidSdkVersion string

The version of the Connectif SDK used in the mobile app in Android (only if mobile app integration is enabled).

 Optional
_averagePurchasesAmount number

Average amount of the registered contact purchases.
_birthdate date-time

Birthdate of the contact in ISO8601 format.

 Optional
_churnRate number

The opposite of p-alive. The probability that the customer has churned on us. The value is expressed as percentage from 0 to 100. If the value is null it means the contact is not a buyer or the CLV metrics are not enabled in your account. More info https://support.connectif.ai/hc/es/articles/6042260554012.

 Optional
_clv number

Customer Lifetime Value of the contact for the next 12 months. If the value is null it means the contact is not a buyer or the CLV metrics are not enabled in your account. More info https://support.connectif.ai/hc/es/articles/6042260554012.

 Optional
_createdAt date-time

The date of creation of the contact in ISO8601 format.
_email email

The email that identifies the contact.
_emailBouncedReason string

Description of the reason why the last bounced email sent to the contact was bounced.

 Optional
_emailLastBouncedDate date-time

The date of the last time an email sent to the contact was hard-bounced in ISO8601 format.

 Optional
_emailLastSoftBounceDate date-time

The date of the last time an email sent to the contact was soft-bounced in ISO8601 format.

 Optional
_emailLastUnsubscribedDate date-time

The date of the last time the contact unsubscribed from email newsletter in ISO8601 format.

 Optional
_emailLastUnsubscribedIp ip

The IP address from which the contact unsubscribed to the email newsletter for the last time.

 Optional
_emailSoftBounces integer

How many soft bounces have happened when sending emails to the contact.

 Optional
_emailStatus string

Status of the email address of the contact: active (email address is valid and can receive emails), bounced, paused or banned.

Possible values are:

  • active
  • bounced
  • paused
  • banned
_expectedPurchases number

It represents how many purchases we can expect to see up to the next 12 months from this contact. If the value is null it means the contact is not a buyer or the CLV metrics are not enabled in your account. More info https://support.connectif.ai/hc/es/articles/6042260554012.

 Optional
_firstPurchaseDate date-time

The date of the first time a purchase of the contact was registered in ISO8601 format.

 Optional
_frequency string

RFM - Frequency value.

Possible values are:

  • 1
  • 2
  • 3
  • 4
  • 5
 Optional
_hasPushSubscriptions boolean

Whether the contact has at least 1 push subscription or not.
_iosAppVersion string

The version of the mobile app in iOS (only if mobile app integration is enabled).

 Optional
_iosLastActivityDate date-time

The date of the last activity of the contact in the mobile app in iOS, in ISO8601 format (only if mobile app integration is enabled).

 Optional
_iosOsVersion string

The version of the iOS operating system (only if mobile app integration is enabled).

 Optional
_iosSdkVersion string

The version of the Connectif SDK used in the mobile app in iOS (only if mobile app integration is enabled).

 Optional
_isAnonymous boolean

Whether the contact has an email address or not.
_lastPurchaseDate date-time

The date of the last time a purchase of the contact was registered in ISO8601 format.

 Optional
_mobilePhone international

The phone number of the contact in international format.

 Optional
_mobilePhoneStatus string

Status of the phone number of the contact: active (phone number is valid and can receive SMS), bounced or paused.

Possible values are:

  • active
  • bounced
  • paused
_monetary string

RFM - Monetary value.

Possible values are:

  • 1
  • 2
  • 3
  • 4
  • 5
 Optional
_name string

The name of the contact.

 Optional
_newsletterSubscriptionStatus string

Status of subscription of the contact to the email newsletter: subscribed, unsubscribed or none (not specified yet).

Possible values are:

  • subscribed
  • unsubscribed
  • none
_pAlive number

The probability of the customer being alive. By alive we understand that the customer could buy from us again. The value is expressed as percentage from 0 to 100. If the value is null it means the contact is not a buyer or the CLV metrics are not enabled in your account. More info https://support.connectif.ai/hc/es/articles/6042260554012.

 Optional
_points integer

The score of the contact.
_recency string

RFM - Recency value.

Possible values are:

  • 1
  • 2
  • 3
  • 4
  • 5
 Optional
_rfm string

RFM - Segment.

Possible values are:

  • champions
  • loyal
  • potential-loyalist
  • new-customers
  • promising
  • need-attention
  • about-to-sleep
  • at-risk
  • cannot-lose-them
  • hibernating-customers
  • lost-customers
 Optional
_smsSubscriptionStatus string

Status of subscription of the contact to the SMS newsletter: subscribed, unsubscribed or none (not specified yet).

Possible values are:

  • subscribed
  • unsubscribed
  • none
_surname string

The surname of the contact.

 Optional
_totalPurchases integer

How many purchases of the contact have been registered.
_totalPurchasesAmount number

Total amount of the registered contact purchases.
_updatedAt date-time

The date of last update of the contact in ISO8601 format.

 Optional
_usesMobileApp boolean

Whether the contact uses the mobile app or not (only if mobile app integration is enabled).

 Optional
id string

The tracker id of the contact.