/netevia/subProfiles/phone

Update Subprofile Phone Number

This endpoint updates the phone number associated with a subprofile (authorized user) on a business customer account. It requires both a country code and a 10-digit phone number. Use this endpoint whenever an authorized user's contact phone number needs to be corrected or changed.

Endpoint

POST /netevia/subProfiles/phone

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token} Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when an authorized user (subprofile) of a business customer has changed their phone number or when the phone number on record needs to be corrected. Keeping subprofile contact information current ensures that notifications, verification codes, and account alerts are delivered to the correct number. This is especially important for subprofiles with Full or Custom access levels who may receive security-related communications.

Request Body

{
  "subProfileId": 48291,
  "phoneNumberCountryCode": "001",
  "phoneNumber": "8005550199"
}

Response

200 OK

A 200 response indicates the subprofile phone number was successfully updated. The response body confirms success with no additional fields returned.

{}

Error Codes

Common Mistakes

• Providing a phone number with fewer or more than exactly 10 digits — the phoneNumber field enforces a strict 10-character length and will reject values like "800-555-0199" (includes dashes) or "+18005550199" (includes country prefix)
• Providing a phoneNumberCountryCode that is not exactly 3 characters — use "001" for the US, not "1" or "+1"
• Omitting subProfileId when multiple subprofiles exist on the account, which may result in an ambiguous or failed update
• Sending the phone number with formatting characters such as parentheses, spaces, or dashes — only numeric digits are accepted

Related Endpoints

• POST /netevia/subProfiles — Create a new subprofile (authorized user) for a business customer
• GET /netevia/subProfiles — Retrieve all subprofiles associated with a business customer account
• PUT /netevia/subProfiles — Update general subprofile information
• POST /netevia/subProfiles/email — Update the email address for a subprofile

Example

curl -X POST https://api.banking.netevia.dev/netevia/subProfiles/phone \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subProfileId": 48291,
    "phoneNumberCountryCode": "001",
    "phoneNumber": "8005550199"
  }'