CNContactStore.ContactsMatchingEmailAddress
-------------------------------------------

Find the contacts whose email address matches the specified value.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Contacts](component_Contacts.md) | [10.5](newinversion105.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "CNContactStore.ContactsMatchingEmailAddress"; emailAddress ) 

**MBS**( **"CNContactStore.ContactsMatchingEmailAddress";** /\* Find the contacts whose email address matches the specified value. \*/  
**$emailAddress**) /\* The email address to be matched. \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| emailAddress | The email address to be matched. |  |

### Result

Returns list or error.

### Description

Find the contacts whose email address matches the specified value.  
Requires macOS 10.13 or newer.  
### Examples

Find someone by email:

 Let(\[  
email = "bob@monkeybreadsoftware.de";  
contacts = MBS ("CNContactStore.ContactsMatchingEmailAddress"; email);  
contact = getValue(contacts; 1);  
name = MBS ( "[CNContact.Name](CNContactName.md)"; contact )  
\]; name)  
### See also

- [CNContact.Name](CNContactName.md)
- [CNContactStore.Contacts](CNContactStoreContacts.md)
- [CNContactStore.ContactsMatchingName](CNContactStoreContactsMatchingName.md)
- [CNContactStore.ContactsMatchingPhoneNumber](CNContactStoreContactsMatchingPhoneNumber.md)

### Release notes

- **Version 10.5**
    - Added [CNContactStore.ContactsMatchingEmailAddress](https://www.mbsplugins.eu/CNContactStoreContactsMatchingEmailAddress.shtml) and [CNContactStore.ContactsMatchingPhoneNumber](https://www.mbsplugins.eu/CNContactStoreContactsMatchingPhoneNumber.shtml) functions.

### Blog Entries

- [New in MBS FileMaker Plugin 10.5](https://www.mbsplugins.de/archive/2020-11-23/New_in_MBS_FileMaker_Plugin_10/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.5pr1](https://www.mbsplugins.de/archive/2020-10-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 15th September 2020 , last changed 23th November 2023

  
[CNContactStore.ContactsInGroup](CNContactStoreContactsInGroup.md) - [CNContactStore.ContactsMatchingName](CNContactStoreContactsMatchingName.md)

[HTML Version](CNContactStoreContactsMatchingEmailAddress.shtml)