A phone number was changed. When the Program API makes the change, this event is triggered when any value is passed for a parameter, even when the value is the same as the old value.
- Code —
PHCH - Event trigger — One of these fields changes:
- Primary phone
- Other phone
- Mobile phone
- Processes — These processes contain the event trigger:
- Update Account endpoint
- Customer Service Tool
Fields
All fields are strings. Your field names may vary. Default fields are included in the default webhook template. See Default and optional fields for more information.
| Field | Default | Description |
|---|---|---|
| avail_cash | For debit accounts, the |
|
| avail_credit | For credit accounts, the available credit limit to spend. Example: |
|
| balance_id | X | The balance ID, also called the |
| cad | System-generated card ID. Example: |
|
| carrier_id | X | Integer ID for the mobile carrier. Example: |
| ch_group_id | Corporate Hierarchy group identifier. Example: |
|
| credit_balance | For credit accounts, the total amount of unpaid purchases and advances. Example: |
|
| extcustid | Identifier used to associate multiple accounts under the same customer. This identifier is supplied by the provider, not SoFi Tech Solutions. Example: |
|
| firstname | X | Account holder's first name. Example: |
| home_phone | X | New home phone number. Example: |
| mobile_phone | X | New mobile phone number. Example: |
| msg_event_id | Unique system-generated identifier for this message. Example: |
|
| msg_id | The four-letter code to identify this event. Example: |
|
| old_home_phone | X | Old home phone number. Example: |
| old_mobile_phone | X | Old mobile phone number. Example: |
| old_other_phone | X | Old other (secondary) phone number. Example: |
| open_to_buy | X | The available balance to spend. Example: |
| other_phone | X | New other (secondary) phone number. Example: |
| pmt_ref_no | X | SoFi Tech Solutions 12-digit payment reference number (PRN) for the account. Example: |
| prod_id | X | The product ID of the account. Example: |
| prog_id | X | The program ID of the account. Example: |
| timestamp | X | Timestamp for when this event was created, in system time. Format: |
| type | X | The name of this event: |
| user_data | Populated according to your use case and needs by arrangement with SoFi Tech Solutions. |
Example
# phone_changed example:
{
"avail_cash": "143.11",
"avail_credit": "432.00",
"balance_id": "20211",
"cad": "12534",
"carrier_id": "23",
"credit_balance": "325.00",
"extcustid": "acv#-@45!sbsxm%-",
"firstname": "Tom",
"home_phone": "8015553234",
"mobile_phone": "8015553768",
"msg_event_id": "243693",
"msg_id": "PHCH",
"old_home_phone": "8015553076",
"old_mobile_phone": "8015553211",
"old_other_phone": "8015558324",
"open_to_buy": "500.00",
"other_phone": "8015553222",
"pmt_ref_no": "999101003022",
"prod_id": "1701",
"prog_id": "305",
"timestamp": "2025-01-31 17:20:33 MST",
"type": "phone_changed"
}