Addressbook.multivalue.addValue
-------------------------------

Adds a value and its label to a multivalue list.

| 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.addValue"; Value; Label ) 

**MBS**( **"Addressbook.multivalue.addValue";** /\* Adds a value and its label to a multivalue list. \*/  
**$Value**; /\* The value to add.e.g. "test@test.test" \*/   
**$Label**) /\* The label to associate with the value.e.g. "Work" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Value | The value to add. | "test@test.test" |
| Label | The label to associate with the value. | "Work" |

### Result

Returns identifier or error.

### Description

Adds a value and its label to a multivalue list.  
Returns the new identifier if value is added successfully; otherwise, nil.  
  
Possible labels are:  
kABHomePageLabel, kABEmailWorkLabel, kABEmailHomeLabel, kABAddressHomeLabel, kABAddressWorkLabel, kABAnniversaryLabel, kABFatherLabel, kABMotherLabel, kABParentLabel, kABBrotherLabel, kABSisterLabel, kABChildLabel, kABFriendLabel, kABSpouseLabel, kABPartnerLabel, kABAssistantLabel, kABManagerLabel, kABPhoneWorkLabel, kABPhoneHomeLabel, kABPhoneiPhoneLabel, kABPhoneMobileLabel, kABPhoneMainLabel, kABPhoneHomeFAXLabel, kABPhoneWorkFAXLabel, kABPhonePagerLabel, kABAIMWorkLabel, kABAIMHomeLabel, kABJabberWorkLabel, kABJabberHomeLabel, kABMSNWorkLabel, kABMSNHomeLabel, kABYahooWorkLabel, kABYahooHomeLabel, kABICQWorkLabel, kABICQHomeLabel, kABWorkLabel, kABHomeLabel, kABOtherLabel or kABMobileMeLabel.  
### Examples

Add a new URL to a contact:

 Set Variable \[$r ; MBS ( "[Addressbook.multivalue.New](AddressbookmultivalueNew.md)") \]  
Set Variable \[$ID ; MBS ( "Addressbook.multivalue.addValue"; "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](AddressbookmultivalueNew.md)" )  
$WorkEmailID = MBS ( "Addressbook.multivalue.addValue"; Addressbook::WorkEmail ; "EmailWorkLabel" )  
$HomeEmailID = MBS ( "Addressbook.multivalue.addValue"; Addressbook::HomeEmail ; "EmailHomeLabel" )  
$r = MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $WorkEmailID )  
$r = MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "EmailProperty"; "multivalue" )  
Add an address:

 # Add one address   
Set Variable \[$result ; Value:MBS ( "[Addressbook.multivalue.New](AddressbookmultivalueNew.md)"; 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](AddressbookmultivalueNew.md)")  
Set Variable \[$id ; Value:MBS ( "Addressbook.multivalue.addValue"; $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](AddressbookmultivalueNew.md)"\]  
Set Variable \[$tel\_id ; Value:MBS ( "Addressbook.multivalue.addValue"; $tel ; "PhoneWorkLabel" )\]  
Set Variable \[$mob\_id ; Value:MBS ( "Addressbook.multivalue.addValue"; $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" )\]  
Add homepage URLs:

 # add homepages   
Set Variable \[ $r ; Value: MBS ( "[Addressbook.multivalue.New](AddressbookmultivalueNew.md)" ) \]   
Set Variable \[ $Blog\_URL\_ID ; Value: MBS ( "Addressbook.multivalue.addValue"; "http://www.mbsplugins.de/"; "Blog" ) \]   
Set Variable \[ $Homepage\_URL\_ID ; Value: MBS ( "Addressbook.multivalue.addValue"; "http://www.monkeybreadsoftware.com/"; "HomePageLabel" ) \]   
Set Variable \[ $r ; Value: MBS ( "[Addressbook.multivalue.setPrimaryIdentifier](AddressbookmultivaluesetPrimaryIdentifier.md)"; $Homepage\_URL\_ID ) \]   
Set Variable \[ $r ; Value: MBS ( "[Addressbook.record.SetValueForProperty](AddressbookrecordSetValueForProperty.md)"; $personID ; "URLsProperty"; "multivalue" ) \]  
### See also

- [Addressbook.addRecord](AddressbookaddRecord.md)
- [Addressbook.multivalue.identifiers](Addressbookmultivalueidentifiers.md)
- [Addressbook.multivalue.insertValue](AddressbookmultivalueinsertValue.md)
- [Addressbook.multivalue.labels](Addressbookmultivaluelabels.md)
- [Addressbook.multivalue.New](AddressbookmultivalueNew.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.multivalue.addAddress](AddressbookmultivalueaddAddress.md) - [Addressbook.multivalue.count](Addressbookmultivaluecount.md)

[HTML Version](AddressbookmultivalueaddValue.shtml)