Set a contact's primary email and/or phone

Sets which of the contact's known emails and phone numbers are its primary ones. Primaries are chosen by value: primaryEmail must be one of the addresses already on the contact and primaryPhone one of its phone numbers, written exactly as they appear on the list row (emails[].email, phones[].phoneNumber); a value the contact does not carry is rejected with 422 PRIMARY_VALUE_NOT_ON_CONTACT and nothing is changed. The call promotes an existing value and never adds a new one — enrich the contact to add addresses or numbers. Send either field or both; the response reports both primaries as they now stand. Free to call.

Errors:

• 404 CONTACT_NOT_FOUND — No contact with that id exists.
• 422 PRIMARY_VALUE_NOT_ON_CONTACT — The value is not one the contact already carries; param names which of primaryEmail / primaryPhone was rejected and nothing was changed.
• 422 VALIDATION_FAILED — The body failed validation, including a body with neither primaryEmail nor primaryPhone.
• 429 RATE_LIMITED — More than 120 requests per minute or 10,000 per day on the contacts bucket, which every /business/contacts endpoint shares; retry after Retry-After.
• 500 UNEXPECTED_ERROR — The request could not be completed; quote request_id to support.

Requires one of the following token scopes: contacts.