Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Adds an relation to a contact.

Component Version macOS Windows Linux Server iOS SDK
Contacts 8.4 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContact.AddRelation"; ContactIdentifier; Name; Label )   More


Parameter Description Example
ContactIdentifier The contact identifier. "46B1E34D-58F9-4B6B-A80D-0F71ABB87A0E"
Name The name to use. "Christian Schmitz"
Label The label to use.
For your convenience we translate Assistant, Brother, Child, Daughter, Father, Friend, Manager, Mother, Parent, Partner, Sister, Son and Spouse to the right values, so they get localized in display.
Default label is Other.


Returns OK or error.


Adds an relation to a contact.
This is a convenience function to add just one relation with a given label to the contact.
Please call CNContactStore.UpdateContact later to store the values.

See also

Example Databases

Created 1st August 2018, last changed 2nd August 2018

CNContact.AddPostalAddressJSON - CNContact.AddSocialProfile