Skip to main content

Create a contact

POST 

/api/contacts

Adds a person to the user's contacts, for example a sender from an open message, and returns the contact created by the Contacts app with the addressBookId it was saved in.

The contact always goes into the user's first address book. Only givenName, familyName and emails are passed on; at least one email address and some name (givenName, familyName or name) are required.

Needs the session's platform access token (401 without one). Returns 404 when the user has no address book and 424 when no Contacts app is found or it refuses the request.

Request​

Responses​

Created contact, including addressBookId.