Contacts
Set or clear verification on a contact's phone or email entry
Toggles verification metadata on a single entry in a contact's phoneNumber[] or email[] array. Pass verifiedAt as an ISO timestamp to mark the entry verified (also stamps verifiedBy from the caller and the supplied verificationSource); pass verifiedAt: null (or omit it) to clear all three. Phone values are normalized via the same E.164 helper the rest of the API uses; email values are lower-cased. Scoped to the caller's organization unless SUPERADMIN. Emits a contact_updated socket event and writes a manual-event audit entry (CONTACT_METHOD_VERIFIED / CONTACT_METHOD_UNVERIFIED).
Authorization
bearerAuth In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Toggle verification on a single phone or email entry. value must match an existing entry on the contact (phones are normalized to E.164; emails are lower-cased). Pass verifiedAt to mark verified; pass null (or omit) to clear.
Response Body
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/api/contacts/string/verify-contact-methods" \ -H "Content-Type: application/json" \ -d '{ "type": "phone", "value": "+14165550100", "verifiedAt": "2026-05-20T15:04:01.135Z", "verificationSource": "admin-manual" }'{ "message": "Phone number verified", "data": { "contact": { "_id": "64b2c3d4e5f60012345678aa", "firstName": "Alex", "lastName": "Morgan", "phoneNumber": [ { "value": "+14165550100", "isPrimary": true, "verifiedAt": "2026-05-20T15:04:01.135Z", "verifiedBy": "64a1b2c3d4e5f60012345679", "verificationSource": "admin-manual" } ] } }}