Verizon 5G Edge API Portal
Verizon 5G EdgeThingSpace
HomeSDKsContext PluginAPI Reference
Device Management

Changes the name and address associated with a device.

PUT
/m2m/v1/devices/actions/contactInfo

Sends a CarrierService callback message for each device in the request when the contact information has been changed, or if there was a problem and the change could not be completed.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Request to update contact information for devices.

Request to update contact information for devices.

primaryPlaceOfUse*

The customer name and the address of the device's primary place of use. Leave these fields empty to use the account profile address as the primary place of use. These values will be applied to all devices in the request.If the account is enabled for non-geographic MDNs and the device supports it, the primaryPlaceOfUse address will also be used to derive the MDN for the device.

accountName?string

The name of the billing account that the devices belong to. An account name is usually numeric, and must include any leading zeros.

devices?array<>

A list of the devices that you want to change, specified by device identifier. You only need to provide one identifier per device. Do not include accountName, groupName, customFields, or servicePlan if you use this parameter.

Response Body

application/json

application/json

curl -X PUT "https://example.com/m2m/v1/devices/actions/contactInfo" \  -H "Content-Type: application/json" \  -d '{    "devices": [      {        "deviceIds": [          {            "kind": "ESN",            "id": "19110173057"          },          {            "kind": "ESN",            "id": "19110173057"          }        ]      }    ],    "accountName": "0000123456-00001",    "primaryPlaceOfUse": {      "address": {        "addressLine1": "9868 Scranton Rd",        "addressLine2": "Suite A",        "city": "San Diego",        "state": "CA",        "country": "USA",        "zip": "92121",        "zip4": "0001",        "phone": "1234567890",        "phoneType": "H",        "emailAddress": "zaffod@theinternet.com"      },      "customerName": {        "firstName": "Zaffod",        "lastName": "Beeblebrox",        "middleName": "P",        "title": "President",        "suffix": "I"      }    }  }'
{  "requestId": "24da9f9a-d110-4a54-86b4-93fb76aab83c"}

Adds up to 200 new devices, without provisioning lines of service for them. POST

Use this API if you want to manage some device settings before you are ready to activate service for the devices.

Updates one or more custom field values for devices. PUT

Sends a CarrierService callback message for each device in the request when the custom fields have been changed, or if there was a problem and the change could not be completed.