API – Customer Phones
General
To edit customer phone numbers, send a PUT request to the URL of the customer.
Below is a sample body:
{
"Phones": {
"results": [
{
"entityId": 3,
"entityType": "Entity.Customer",
"phone": "5555555555",
"type": "customer.phoneType.cell",
"isPrimary": 1,
"isSecondary": 0,
"sbtMktVerifyPIN": "0",
"sbtActVerifyPIN": "0",
"sbtMktVerifyPending": 0,
"sbtActVerifyPending": 0,
"sbtMktVerified": 0,
"sbtActVerified": 0,
"carrierName": "null",
"carrierVerified": 1,
"isLandLine": 0,
"dndEnabled": 0,
"active": 1,
"_updateIndex": 0,
"_index": 0,
"delete": false,
"__isDirty": true,
"__lookupInProgress": false
},
{
"phone": "6666666666",
"isPrimary": "0",
"isSecondary": "1",
"delete": false,
"_index": 1,
"type": "customer.phoneType.home",
"__isDirty": true,
"carrierVerified": 1,
"__lookupInProgress": false,
"carrierName": null,
"isLandLine": 0
},
{
"phone": "7777777777",
"isPrimary": "0",
"isSecondary": "0",
"delete": false,
"_index": 2,
"type": "customer.phoneType.fax",
"__isDirty": true,
"carrierVerified": 1,
"__lookupInProgress": false,
"carrierName": null,
"isLandLine": 0
},
{
"phone": "8888888888",
"isPrimary": "0",
"isSecondary": "0",
"delete": false,
"_index": 3,
"type": "customer.phoneType.cellSmartPhone",
"__isDirty": true,
"carrierVerified": 1,
"__lookupInProgress": false,
"carrierName": null,
"isLandLine": 0
},
{
"phone": "9999999999",
"isPrimary": "0",
"isSecondary": "0",
"delete": false,
"_index": 4,
"type": "customer.phoneType.office",
"__isDirty": true,
"carrierVerified": 1,
"__lookupInProgress": false,
"carrierName": null,
"isLandLine": 0
},
{
"phone": "4444444444",
"isPrimary": "0",
"isSecondary": "0",
"delete": false,
"_index": 5,
"type": "customer.phoneType.other",
"__isDirty": true,
"carrierVerified": 1,
"__lookupInProgress": true,
"carrierName": null,
"isLandLine": 0
}
]
}
}
Fields common to all phone numbers
- phone – The phone number
- isPrimary – Whether or not this is the primary phone number
- isSecondary – Whether or not this is the secondary phone number
- delete – Whether or not to delete the phone number from the customer
- _index – The order to display the phone number (starts from 0)
- type – The type of the phone number (formatted “customer.phoneType.<Type>”
- Values for <Type>
- cell – A cell phone
- cellSmartPhone – A smart cellular phone
- home – A home phone
- fax – A fax number
- office – An office/work phone
- other – Other phone
- Values for <Type>
- __isDirty – If the phone number has been changed (set to “true” for all update and creation requests)
- carrierVerified – Whether or not a carrier lookup has been performed
- __lookupInProgress – Whether or not a carrier lookup is in progress
- carrierName – The name of the carrier
- isLandLine – Whether or not the carrier reports that the phone is a land line
Fields for SBT verified phone numbers
These fields are only applicable if you want to use Solutions By Text (SBT) for a phone number
- sbtMktVerifyPIN – The SBT Marketing Verification PIN
- sbtActVerifyPIN – The SBT Account Verify PIN
- sbtMktVerifyPending – Whether or not verification for SBT Marketing is pending
- sbtActVerifyPending – Whether or not verification for SBT Account is pending
- sbtMktVerified – Whether or not the number has been verified for SBT Marketing
- sbtActVerified – Whether or not the number has been verified for SBT Account