Phone Numbers in Welkin
The Welkin platform supports phone number formatting validation to ensure that a valid number is saved.
Dependent on country code, patient and coach phone numbers, have different sets of validation. For a Phone Number to successfully be added, edited, or updated in Welkin the country’s validation format must be followed.
To prevent accidentally incurring outbound long distance phone charges due to mis-typed phone numbers, Welkin sets the default for the allowed phone numbers to be the same as the country your Organization’s program is executed in. If you require additional countries to be enabled for your Program, please contact your Welkin Customer Success Representative to coordinate which countries you wish to enable outbound calling to (note that any person, in any country may call inbound to the number that is associated with your program).
Coach Phone Numbers
Phone Numbers may be entered in the “Edit Account” section of a coach Account, and Welkin will not allow you to add dashes, parentheses, or spaces. If a coach Phone Number is not entered in the correct format, the error message “Field/e164_phone_number must be a valid international e164 phone number” will appear and you will not be able to “Save”:
Patient Phone Numbers
Phone Numbers imported in Welkin through APIs must include Area Codes and may not contain dashes, parentheses, or spaces.
Phone Numbers added when creating or editing patient will automatically add dashes, parentheses, and spaces.
If a patient Phone Number is not entered in the correct format, the error message “Phone Number must be a valid phone number” will appear and you will not be able to “Update Patient”:
United States Phone Number Format
The valid Phone Number format for United States patient and coach accounts are as follows:
- Country Code (1), Area Code (where A is the three digit area code), phone number (B)
- 1 AAA BBB BBBB
- 10 digits total
- If Phone Numbers are being imported in Welkin through APIs make sure there are no dashes, parentheses, or spaces.
Australia Phone Number Format
The valid Phone Number format for Australian patient and coach accounts are as follows:
- Country Code (0), Area Code (where A is either 2, 3, 7, 8), phone number (B)
- 0A BBBB BBBB
- 0ABB BBB BBB
- 10 digits total
UK Phone Number Format
The valid Phone Number format for UK patient and coach accounts are as follows:
- Country Code (0), Area Code, phone number (B)
- 02x BBBB BBBB
- 011x BBB BBBB
- 01x1 BBB BBBB
- 01xxx BBBBB or 01xxx BBBBBB
- Dependent on the Area Code digit totals are either 8-digit, 7-digit, or 5 or 6 digit all seen associated with the Area Codes above.
Ireland Phone Number Format
The valid Phone Number format for Ireland patient and coach accounts are as follows:
- Country Code (0), Area Code (up to four digits but often three, A), phone number or subscriber number (ranging from 5-7 digits long, B)
- 0A BBB BBBB
- 0A BBB BBB
- 0A BBBBB
- 9 digits total
Germany Phone Number Format
The valid Phone Number format for Germany patient and coach accounts are as follows:
- Country Code (0), Area Code (have no fixed length, A), phone number (have no fixed length, B), possible extension (X)
- 0AAAA BBBBBB
- 0AAAA BBBBBB-XX
- 0 AAAA BBBBBB
- 0 AAAA BBBBBB
- 11 digits total
Austria Phone Number Format
The valid Phone Number format for Austria patient and coach accounts are as follows:
- Digit total varies. No standard length for area codes or subscriber numbers in Austria.
Switzerland Phone Number Format
The valid Phone Number format for Switzerland patient and coach accounts are as follows:
- Country Code (0), National Destination Code (A), phone number (B)
- 0AA BBB BB BB
- 10 digits total
Belgium Phone Number Format
The valid Phone Number format for Belgium patient and coach accounts are as follows:
- Country Code (0), Zone Prefix (1, 2 or 3 digits, A), phone number or subscriber’s number (B)
- 0AA BB BB BB
- 0A BBB BB BB
- 04AA BB BB BB
- 04AA BBB BBB
- 9 digits total for landlines
- 10 digits total for mobile phones, where the Zone Prefix is always 4 for a mobile number.
Netherlands Phone Number Format
The valid Phone Number format for Netherlands patient and coach accounts are as follows:
- Country Code (0), Area Code (1, 2 or 3 digits, A), phone number or subscriber’s number (B)
- 0AA BBBBBBB
- 0AAA BBBBBB
- 10 digits total
- Service numbers are often 8 or 11 digits total with area codes 800, 900, 906, and 909.
- Government numbers are often 5 or 6 digits total, with the area code 14.
Sweden Phone Number Format
The valid Phone Number format for Sweden patient and coach accounts are as follows:
- Country Code (0), Area Code (2, 3, or 4 digits, A), phone number (B)
- 0A BBB BBB BB
- 0AA BBB BB BB
- 0AAA BB BB BB
- 0A BBB BB BB
- 0AA BB BB BB
- 0AAA BBB BB
- 0A BB BB BB
- 0A BBB BB
- 07A BBB BB BB
- 07AA BB BB BB
- 8-10 digits total
- Mobile number Area Code are 3 digits and begin with 07, and in total are 10 digits.
After following these troubleshooting steps, if issues persist, don’t hesitate to reach out to support.welkinhealth.com.