Contacts

Set or clear verification on a contact's phone or email entry

PATCH
/api/contacts/{id}/verify-contact-methods

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
AuthorizationBearer <token>

In: header

Path Parameters

id*string

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"        }      ]    }  }}