Addressbook.multivalue.New
--------------------------

Creates a new multivalue object.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Addressbook](component_Addressbook.md) | [3.1](newinversion31.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

### Deprecated

This function was [deprecated](deprecated.md). Use [Contacts](component_Contacts.md) functions instead.

MBS( "Addressbook.multivalue.New" { ; Addresses } ) 

**MBS**( **"Addressbook.multivalue.New";** /\* Creates a new multivalue object. \*/  
**$Addresses**) /\* Optional; Whether you want to store address information. Pass 1 if you plan to use this multivalue with AddressProperty.e.g. 1 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| Addresses | Whether you want to store address information. Pass 1 if you plan to use this multivalue with AddressProperty. | 1 | Optional |

### Result

Returns OK on success and error on failure.

### Description

Creates a new multivalue object.   
You create such a MultiValue object, add values to it and then use [Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md) to assign it to a record.  
### Examples

Add a new URL to a contact:

 Set Variable \[$r ; MBS ( "Addressbook.multivalue.New") \]  
Set Variable \[$ID ; MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; "http://www.mbsplugins.de"; "WorkLabel" ) \]   
Set Variable \[$r ; MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $ID ) \]  
Set Variable \[$r ; MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "URLsProperty"; "multivalue" ) \]  
Add work and home emails:

 $r = MBS ( "Addressbook.multivalue.New" )  
$WorkEmailID = MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; Addressbook::WorkEmail ; "EmailWorkLabel" )  
$HomeEmailID = MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; Addressbook::HomeEmail ; "EmailHomeLabel" )  
$r = MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $WorkEmailID )  
$r = MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "EmailProperty"; "multivalue" )  
Add an address:

 Set Variable \[$result ; Value:MBS ( "Addressbook.multivalue.New"; 1 )   
Set Variable \[$id ; Value:MBS ( "[Addressbook.multivalue.addAddress](AddressbookmultivalueaddAddress.md)"; $str ; $plz ; $ort ; $land ; ""; "" )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $id )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "AddressProperty"; "multivalue" )\]  
Add an email:

 Set Variable \[$result ; Value:MBS ( "Addressbook.multivalue.New")  
Set Variable \[$id ; Value:MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; $email ; "EmailWorkLabel" )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $id )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "EmailProperty"; "multivalue" )\]  
Add phone numbers:

 Set Variable \[$result ; Value:MBS ( "Addressbook.multivalue.New"\]  
Set Variable \[$tel\_id ; Value:MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; $tel ; "PhoneWorkLabel" )\]  
Set Variable \[$mob\_id ; Value:MBS ( "[Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)"; $mob ; "PhoneMobileLabel" )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $mob\_id )\]  
Set Variable \[$result ; Value:MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "PhoneProperty"; "multivalue" )\]  
### See also

- [Addressbook.addRecord](AddressbookaddRecord.md)
- [Addressbook.multivalue.addAddress](AddressbookmultivalueaddAddress.md)
- [Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)
- [Addressbook.multivalue.count](Addressbookmultivaluecount.md)
- [Addressbook.multivalue.labels](Addressbookmultivaluelabels.md)
- [Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)
- [Addressbook.multivalue.values](Addressbookmultivaluevalues.md)
- [Addressbook.NewPerson](AddressbookNewPerson.md)
- [Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)
- [Addressbook.save](Addressbooksave.md)

### Example Databases

- [Mac and iOS/Addressbook/Addressbook](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Addressbook/Addressbook.shtml#3ScriptAnchor_)

### Blog Entries

- [Filemaker and the Mac OS X Addressbook](https://www.mbsplugins.de/archive/2013-05-04/Filemaker_and_the_Mac_OS_X_Add/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 6th September 2025

  
[Addressbook.me](Addressbookme.md) - [Addressbook.multivalue.addAddress](AddressbookmultivalueaddAddress.md)

[HTML Version](AddressbookmultivalueNew.shtml)