---
title: "Create a personal alert contact"
method: POST
path: "/alert-contacts"
tags: ["Alert Contacts"]
---

# Create a personal alert contact

`POST /alert-contacts`

Create a personal alert contact. Email and push (iOS/Android) are supported; Pro SMS and voice require phone verification and are not creatable here.

## Request body

- CreatePersonalAlertContactDto
  - `type` 'Email' | 'ProSms' | 'Voice' | 'MobileAppIOS' | 'MobileAppAndroid' | 'MobileAppOld' | 'MobileApp', required — Personal alert-contact type. Email and mobile push for iOS or Android are creatable here; Pro SMS and voice require phone verification. Use MobileAppIOS or MobileAppAndroid for mobile push. DEPRECATED: MobileAppOld (use MobileAppIOS) and MobileApp (use MobileAppAndroid) are accepted through October 10, 2026 and will be rejected after that date.
  - `friendlyName` string — Display name of the alert contact
  - `enableNotificationsFor` 0 | 1 | 2 | 3
  - `value` string — Email address (required for Email contacts)
  - `deviceName` string — Device name (push)
  - `oneSignalSubscriptionId` string — OneSignal subscription ID (push)
  - `oneSignalUserId` string — OneSignal user ID (push)
  - `deviceFingerprint` string — Device fingerprint (push)
  - `pushToken` string — Push notification token (push)
  - `platform` 'ios' | 'android' — Device platform (push)
  - `config` AlertContactConfigDto
    - `android_push_up_channel` string
    - `android_push_down_channel` string

## Response `201`

- AlertContactDto — AlertContactPublic
  - `id` number, required
  - `friendlyName` string, nullable, required
  - `type` unknown, required
  - `value` string, nullable, required
  - `customValue` string, nullable, required
  - `enableNotificationsFor` unknown, required
  - `sslExpirationReminder` boolean, nullable, required
  - `httpUsername` string, nullable, required
  - `httpPassword` string, nullable, required
  - `authType` boolean, nullable, required
  - `customHeaders` object, nullable
  - `mobileProviderId` number, nullable, required
  - `status` unknown, required
  - `orgAlertContactId` number, nullable, required
  - `config` object, nullable
    - `android_push_up_channel` string
    - `android_push_down_channel` string

---

[API](https://skmtc.net/uptimerobot/apis/uptimerobot-api.md) · [All operations](https://skmtc.net/uptimerobot/apis/uptimerobot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptimerobot/uptimerobot-api/revisions/2b6fa8c427ba/schema)