BYbyaccrue
Identity Verification

Apply Verified Profile Update

Applies a phone number and/or email update after the user passes identity verification. Requires a valid, unused verificationToken from a successful challenge submission. At least one of phoneNumber or email must be provided. Changing the phone number clears the user's Better Auth session link and marks the updated contact fields as unverified.

post/api/v1/users/:userIdentifier/identity-verification/profile-updates

Request

Path parameters

userIdentifierstring required

Accrue userId or merchant userReference (externalUserId / stableExternalUserId). Accrue resolves the identifier automatically against active wallets for your merchant.

Example:merchant-user-42

Headers

Client-IDstring uuid required

The unique identifier of the client making the request. This header is required to retrieve the client-specific configuration and ensure that the response is tailored to the client's settings and permissions.

Example:123e4567-e89b-12d3-a456-426614174000
Authorizationstring uuid required

Secure secret to access privileged endpoints.

Example:Bearer 633b336e4f57f095a405f6685e208cc7dd16de3e82494662f2acfeec3af1cdef

Request body

Example request

{
  "data": {
    "attributes": {
      "verificationToken": "pvt_a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
      "phoneNumber": "+12125551234",
      "email": "user@example.com"
    }
  }
}

Response

Profile update applied successfully.

Example response

{
  "data": {
    "attributes": {
      "phoneNumber": "+12125551234",
      "email": "user@example.com",
      "appliedAt": "2026-06-17T12:35:00.000Z"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.