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

# Add Device

`POST /v1/device-tokens`

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.net/optimove/apis/optimove-api.md) · [All operations](https://skmtc.net/optimove/apis/optimove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimove/optimove-api/versions/fc55c5b1bec5/schema)
