Skip to main content

Add One or More Contacts (utils.add_contacts)

Declaration​

ok = utils.add_contacts({
    {
        firstName = "First1",
        lastName = "Last1",
        phoneNumbers = { "Number1-1", "Number1-2" },
        emails = { "Email1-1", "Email1-2" },
    },
    {
        firstName = "First2",
        lastName = "Last2",
        phoneNumbers = { "Number2-1", "Number2-2" },
        emails = { "Email2-1", "Email2-2" },
    },
    ...
})

Parameters​

  • firstName
    String. Family name.
  • lastName
    String. Given name.
  • phoneNumbers
    Table. Phone numbers list.
  • emails
    Table. Emails list.

Returns​

  • ok
    Boolean. true on success, false on failure.

Description​

Add one or multiple contacts to the system address book.
Note: bulk import may take a long time.

Examples​

utils.add_contacts({
    {
        firstName = "Xiao",
        lastName = "Ming",
        phoneNumbers = { "13800001111", "13800002222" },
        emails = { "[email protected]", "[email protected]" },
    },
    {
        firstName = "Xiao",
        lastName = "Hong",
        phoneNumbers = { "13800003333", "13800004444" },
        emails = { "[email protected]", "[email protected]" },
    },
})