Device Management

Activates service for one or more devices.

POST
/m2m/v1/devices/actions/activate

If the devices do not already exist in the account, this API resource adds them before activation.

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 for activating a service on devices.

Request for activating a service on devices.

devices*array<>

Up to 10,000 devices for which you want to activate service, specified by device identifier.

servicePlan*string

The service plan code that you want to assign to all specified devices.

mdnZipCode*string

The Zip code of the location where the line of service will primarily be used, or a Zip code that you have been told to use with these devices. For accounts that are configured for geographic numbering, this is the ZIP code from which the MDN will be derived.

accountName?string

The name of a billing account.

carrierIpPoolName?string

The private IP pool (Carrier Group Name) from which your device IP addresses will be derived.

carrierName?string

The carrier that will perform the activation.

costCenterCode?string

A string to identify the cost center that the device is associated with.

customFields?array<>

A user-defined descriptive field, limited to 50 characters.

groupName?string

If you specify devices by ID in the devices parameters, this is the name of a device group that the devices should be added to.If you don't specify individual devices with the devices parameter, you can provide the name of a device group to activate all devices in that group.

leadId?string

The ID of a “Qualified” or “Closed - Won” VPP customer lead, which is used with other values to determine MDN assignment, taxation, and compensation.

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.

publicIpRestriction?string

For devices with static IP addresses on the public network, this specifies whether the devices have general access to the Internet.

skuNumber?string

The Stock Keeping Unit (SKU) of a 4G device type can be used with ICCID device identifiers in lieu of an IMEI when activating 4G devices. The SkuNumber will be used with all devices in the request, so all devices must be of the same type.

Response Body

application/json

application/json

curl -X POST "https://example.com/m2m/v1/devices/actions/activate" \  -H "Content-Type: application/json" \  -d '{    "accountName": "0868924207-00001",    "customFields": [      {        "key": "CustomField2",        "value": "SuperVend"      }    ],    "groupName": "4G West",    "primaryPlaceOfUse": {      "customerName": {        "title": "President",        "firstName": "Zaffod",        "lastName": "Beeblebrox"      },      "address": {        "addressLine1": "1600 Pennsylvania Ave NW",        "city": "Washington",        "state": "DC",        "zip": "20500",        "country": "USA"      }    },    "devices": [      {        "deviceIds": [          {            "kind": "imei",            "id": "990013907835573"          },          {            "kind": "iccid",            "id": "89141390780800784259"          }        ],        "ipAddress": "1.2.3.456"      },      {        "deviceIds": [          {            "kind": "imei",            "id": "990013907884259"          },          {            "kind": "iccid",            "id": "89141390780800735573"          }        ],        "ipAddress": "1.2.3.456"      }    ],    "servicePlan": "the service plan name",    "mdnZipCode": "98801"  }'
{  "requestId": "595f5c44-c31c-4552-8670-020a1545a84d"}