UPuptimerobot
Alert Contacts

Create a personal alert contact

Changed on

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

post/alert-contacts

Request

  • Base URL
    https://api.uptimerobot.com/v3
  • URL
    https://api.uptimerobot.com/v3/alert-contacts
  • Auth
    HTTP bearer

Request body

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.

friendlyNamestring

Display name of the alert contact

enableNotificationsFor0 | 1 | 2 | 3
valuestring

Email address (required for Email contacts)

deviceNamestring

Device name (push)

oneSignalSubscriptionIdstring

OneSignal subscription ID (push)

oneSignalUserIdstring

OneSignal user ID (push)

deviceFingerprintstring

Device fingerprint (push)

pushTokenstring

Push notification token (push)

platform'ios' | 'android'

Device platform (push)

Response

idnumber required
friendlyNamestring nullable required
typeunknown required
valuestring nullable required
customValuestring nullable required
enableNotificationsForunknown required
sslExpirationReminderboolean nullable required
httpUsernamestring nullable required
httpPasswordstring nullable required
authTypeboolean nullable required
customHeadersobject nullable
mobileProviderIdnumber nullable required
statusunknown required
orgAlertContactIdnumber nullable required

Changes

  • 191b37343aa3Revision changes
    • warning

      added the new 027-016 enum value to the response property for the response status

  • 8c686e2fe60aRevision changes
    • warning

      added the new 004-048 enum value to the response property for the response status

    • warning

      added the new 011-034 enum value to the response property for the response status

    • warning

      added the new 031-001 enum value to the response property for the response status

    • warning

      added the new 031-002 enum value to the response property for the response status

    • warning

      added the new 031-003 enum value to the response property for the response status

    • warning

      added the new 031-004 enum value to the response property for the response status

    • warning

      added the new 031-005 enum value to the response property for the response status