---
title: "Add Device"
method: POST
path: "/v1/device-tokens"
---

# Add Device

`POST /v1/device-tokens`

## Request

- Base URL: `https://optimobile-push-service-api-region.optimove.net`
- URL: `https://optimobile-push-service-api-region.optimove.net/v1/device-tokens`
- Auth: HTTP basic

This endpoint can be used with Client or Server credentials and registers a device token for the Mobile Push channel, enabling push notifications without requiring a full SDK integration.

## Request body

- object
  - `customerId` string, required: The Optimove CustomerID to match the token to a customer profile
  - `deviceType` 'ios' | 'android', required: The type of device token, one of "ios", "android"
  - `token` string, required: The device token retrieved from the device OS
  - `bundleId` string, required: The package identifier or bundle ID of your mobile app, this must match the provided project credentials in your OptiMobile instance
  - `iosTokenType` 'sandbox' | 'production': Optionally provided for iOS devices, when omitted defaults to "production"

## Response `202`

202

## Other responses

- `401`: 401
- `422`: 422

---

[API](https://skmtc.dev/optimove/apis/optimobile-optiweb-api.md) - [All operations](https://skmtc.dev/optimove/apis/optimobile-optiweb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/optimobile-optiweb-api/revisions/d2df02208951?raw)