Intercom - Create a contact

Important: This connector and its actions have been removed from Nintex Workflow and can now be found in Nintex Gallery.

Use the Intercom - Create a contact action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to create a new contact in Intercom. A contact may be a user or a lead.

For more information about Intercom, go to Intercom.

Before you begin: 

Jump to:

Configure the Intercom - Create a contact action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  1. Select a Connection. If you do not have a connection, see Add a connection.

  1. Enter the contact's details, such as their role, ID, email address, phone number, and name.

  2. Create or select a variable for the output.

Intercom - Create a contact action fields and settings

Section

Field

Description

Variable types

(Unlabeled)

Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

The Intercom connection to use to create a new contact.

To refresh the available connections, click .

(n/a)
  Role

Whether this contact is a user or a sale's lead.

 Text, Decimal, Integer, Boolean, DateTime, Collection
  External ID A unique identifier for the contact which is given to Intercom. Can only be used with the User Role. Text, Decimal, Integer, Boolean, DateTime, Collection
  Email The contact's email address. Text, Decimal, Integer, Boolean, DateTime, Collection
  Phone The contact's phone number. Text, Decimal, Integer, Boolean, DateTime, Collection
  Name The contact's name. Text, Decimal, Integer, Boolean, DateTime, Collection
  Avatar URL An image URL containing the avatar of a contact. Text, Decimal, Integer, Boolean, DateTime, Collection
  Signed up date

The time specified for when a contact signed up.

Unix time (also known as Epoch time, Posix time, seconds since the Epoch, or UNIX Epoch time) is a system for describing a point in time. It is the number of seconds that have elapsed since the Unix epoch, minus leap seconds; the Unix epoch is 00:00:00 UTC on 1 January 1970 (an arbitrary date); leap seconds are ignored, with a leap second having the same Unix time as the second before it, and every day is treated as if it contains exactly 86400 seconds. Unix time is widely used in operating systems and file formats.

The following steps present an example of how to get Unix time from a date in a form input:

  1. In a form, create aDate/time picker control called Target Date.

  2. Add a variable that calculates the TotalSeconds between 1970/1/1 00:00:00 and your target date:

    • dateDiff("TotalSecond", date(1970,1,1,0,0,0), Form.Target Date)
      Unix time

  3. Test the form to make sure that the control is working. For example, selecting 12pm on the 9th of June 2021 should result in a Unix time of 1623240000.

 Text, Decimal, Integer, Boolean, DateTime, Collection
  Last seen date

The time when the contact was last seen (either where the Intercom Messenger was installed or when specified manually).

Unix time (also known as Epoch time, Posix time, seconds since the Epoch, or UNIX Epoch time) is a system for describing a point in time. It is the number of seconds that have elapsed since the Unix epoch, minus leap seconds; the Unix epoch is 00:00:00 UTC on 1 January 1970 (an arbitrary date); leap seconds are ignored, with a leap second having the same Unix time as the second before it, and every day is treated as if it contains exactly 86400 seconds. Unix time is widely used in operating systems and file formats.

The following steps present an example of how to get Unix time from a date in a form input:

  1. In a form, create aDate/time picker control called Target Date.

  2. Add a variable that calculates the TotalSeconds between 1970/1/1 00:00:00 and your target date:

    • dateDiff("TotalSecond", date(1970,1,1,0,0,0), Form.Target Date)
      Unix time

  3. Test the form to make sure that the control is working. For example, selecting 12pm on the 9th of June 2021 should result in a Unix time of 1623240000.

 Text, Decimal, Integer, Boolean, DateTime, Collection
  Unsubscribed from emails Whether the contact is unsubscribed from emails. Boolean
Output Contact

Stores the result of the action as an object. See Intercom - Client API for information on these values.

The following values are returned:

  • Type: (Text)
  • ID: (Text)
  • Workspace ID: (Text)
  • External ID: (Text)
  • Role: (Text)
  • Email: (Text)
  • Phone: (Text)
  • Name: (Text)
  • Avatar URL: (Text)
  • Owner ID: (Integer)
  • Social profiles: (Object)
    • Type: (Text)
    • Data: (Collection)
      • Type: (Text)
      • Name: (Text)
      • URL: (Text)
  • Mark email as spam: (Boolean)
  • Unsubscribed from emails: (Boolean)
  • Created date: (Text)
  • Updated date: (Text)
  • Signed up date:(Text)
  • Last replied date: (Text)
  • Last contacted date: Text)
  • Last email opened date: (Text)
  • Last email clicked date: (Text)
  • Language override: (Text)
  • Location: (Object)
    • Type: (Text)
    • Country: (Text)
    • Region: (Text)
    • City: (Text)
 Object