UptimeRobot

UptimeRobot Alert Contacts API

The Alert Contacts API from UptimeRobot — 2 operation(s) for alert contacts.

GitHub OpenAPI

Operations 5

GET /alert-contacts List personal alert contacts #
POST /alert-contacts Create a personal alert contact #
GET /alert-contacts/{id} Get a personal alert contact by ID #
PATCH /alert-contacts/{id} Update a personal alert contact #
DELETE /alert-contacts/{id} Delete a personal alert contact #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/uptimerobot/openapi/uptimerobot-alert-contacts-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-monitor-pagination-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-monitor-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-monitor-response-time-stats-by-region-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-update-monitor-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-create-keyword-monitor-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/uptimerobot/json-schema/uptimerobot-create-api-monitor-dto-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/uptimerobot/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/uptimerobot:uptimerobot-alert-contacts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

uptimerobot-alert-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: UptimeRobot Alert Contacts API
  description: ''
  version: '3.0'
  contact: {}
servers:
- url: https://api.uptimerobot.com/v3
tags:
- name: Alert Contacts
paths:
  /alert-contacts:
    get:
      description: List the personal alert contacts (email, Pro SMS, voice, iOS/Android push) owned by the authenticated user. Integrations are managed separately through /v3/integrations.
      operationId: AlertContactsController_list
      parameters:
      - name: limit
        required: false
        in: query
        description: 'Maximum number of alert contacts to return per page. Default: 50, Min: 1, Max: 200.'
        schema:
          minimum: 1
          maximum: 200
          example: 50
          type: number
      - name: cursor
        required: false
        in: query
        description: Cursor to paginate through the personal alert contacts
        schema:
          type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertContactPaginationDto'
        default:
          description: An error response. `code` is a member of the published error code vocabulary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
      - bearer: []
      summary: List personal alert contacts
      tags:
      - Alert Contacts
    post:
      description: Create a personal alert contact. Email and push (iOS/Android) are supported; Pro SMS and voice require phone verification and are not creatable here.
      operationId: AlertContactsController_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePersonalAlertContactDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertContactDto'
        default:
          description: An error response. `code` is a member of the published error code vocabulary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
      - bearer: []
      summary: Create a personal alert contact
      tags:
      - Alert Contacts
  /alert-contacts/{id}:
    get:
      description: Get a personal alert contact details by ID
      operationId: AlertContactsController_get
      parameters:
      - name: id
        required: true
        in: path
        description: ID of the personal alert contact
        schema:
          type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertContactDto'
        default:
          description: An error response. `code` is a member of the published error code vocabulary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
      - bearer: []
      summary: Get a personal alert contact by ID
      tags:
      - Alert Contacts
    patch:
      operationId: AlertContactsController_update
      parameters:
      - name: id
        required: true
        in: path
        description: ID of the personal alert contact
        schema:
          type: number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePersonalAlertContactDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertContactDto'
        default:
          description: An error response. `code` is a member of the published error code vocabulary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
      - bearer: []
      summary: Update a personal alert contact
      tags:
      - Alert Contacts
    delete:
      operationId: AlertContactsController_delete
      parameters:
      - name: id
        required: true
        in: path
        description: ID of the personal alert contact
        schema:
          type: number
      responses:
        '200':
          description: ''
        default:
          description: An error response. `code` is a member of the published error code vocabulary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
      - bearer: []
      summary: Delete a personal alert contact
      tags:
      - Alert Contacts
components:
  schemas:
    AlertContactDto:
      description: AlertContactPublic
      type: object
      properties:
        id:
          type: number
        friendlyName:
          type:
          - string
          - 'null'
        type:
          description: Alert-contact type. Mobile push responses retain MobileAppOld (iOS) and MobileApp (Android) through October 10, 2026; consumers should also accept MobileAppIOS and MobileAppAndroid before responses switch to those canonical names after the deadline.
        value:
          type:
          - string
          - 'null'
        customValue:
          type:
          - string
          - 'null'
        enableNotificationsFor: {}
        sslExpirationReminder:
          type:
          - boolean
          - 'null'
        httpUsername:
          type:
          - string
          - 'null'
        httpPassword:
          type:
          - string
          - 'null'
        authType:
          type:
          - boolean
          - 'null'
        customHeaders:
          type:
          - object
          - 'null'
          additionalProperties:
            type: string
        mobileProviderId:
          type:
          - number
          - 'null'
        status: {}
        orgAlertContactId:
          type:
          - number
          - 'null'
        config:
          type:
          - object
          - 'null'
          properties:
            android_push_up_channel:
              type: string
            android_push_down_channel:
              type: string
      required:
      - id
      - friendlyName
      - type
      - value
      - customValue
      - enableNotificationsFor
      - sslExpirationReminder
      - httpUsername
      - httpPassword
      - authType
      - mobileProviderId
      - status
      - orgAlertContactId
    ApiErrorResponseDto:
      type: object
      properties:
        code:
          type: string
          description: A stable, machine-readable error code. Always a member of the published vocabulary.
          enum:
          - 000-001
          - 000-002
          - 000-003
          - 000-004
          - 000-005
          - 000-006
          - 000-007
          - 000-008
          - 000-009
          - 000-010
          - 000-011
          - 000-012
          - 000-013
          - 000-014
          - 003-001
          - 003-002
          - 003-003
          - 003-004
          - 003-005
          - 003-006
          - 003-007
          - 003-008
          - 003-009
          - 003-010
          - 003-011
          - 003-012
          - 003-013
          - 003-014
          - 003-015
          - 003-016
          - 003-017
          - 003-018
          - 003-019
          - 003-020
          - 003-021
          - 004-001
          - 004-002
          - 004-033
          - 004-034
          - 004-035
          - 004-036
          - 004-037
          - 004-038
          - 004-039
          - 004-040
          - 004-041
          - 004-042
          - 004-003
          - 004-004
          - 004-005
          - 004-006
          - 004-007
          - 004-008
          - 004-009
          - 004-010
          - 004-011
          - 004-012
          - 004-013
          - 004-014
          - 004-015
          - 004-016
          - 004-017
          - 004-018
          - 004-019
          - 004-020
          - 004-021
          - 004-022
          - 004-023
          - 004-024
          - 004-025
          - 004-026
          - 004-027
          - 004-028
          - 004-029
          - 004-030
          - 004-031
          - 004-032
          - 004-043
          - 004-044
          - 004-045
          - 005-001
          - 005-002
          - 006-001
          - 009-001
          - 009-002
          - 009-003
          - 009-004
          - 009-005
          - 009-006
          - 009-007
          - 009-008
          - 009-009
          - 009-010
          - 009-011
          - 009-012
          - 009-013
          - 009-014
          - 009-015
          - 009-016
          - 009-017
          - 009-022
          - 009-023
          - 009-024
          - 009-025
          - 009-018
          - 009-019
          - 009-020
          - 009-026
          - 009-027
          - 009-028
          - 009-033
          - 009-034
          - 009-021
          - 009-033
          - 009-030
          - 009-036
          - 009-037
          - 011-001
          - 011-002
          - 011-003
          - 011-004
          - 011-005
          - 011-006
          - 011-007
          - 011-008
          - 011-009
          - 011-010
          - 011-011
          - 011-012
          - 011-013
          - 011-014
          - 011-015
          - 011-016
          - 011-017
          - 011-018
          - 011-019
          - 011-020
          - 011-021
          - 011-022
          - 011-023
          - 011-024
          - 011-025
          - 011-026
          - 011-027
          - 011-028
          - 011-029
          - 013-001
          - 013-002
          - 013-003
          - 013-004
          - 013-005
          - 013-006
          - 013-007
          - 013-008
          - 017-001
          - 017-002
          - 018-001
          - 018-002
          - 018-003
          - 018-004
          - 018-005
          - 018-006
          - 018-007
          - 018-008
          - 018-009
          - 018-010
          - 018-011
          - 018-012
          - 021-001
          - 021-002
          - 021-003
          - 021-004
          - 021-005
          - 021-006
          - 021-007
          - 021-008
          - 021-009
          - 021-010
          - 021-011
          - 021-012
          - 021-013
          - 021-014
          - 021-015
          - 021-016
          - 021-017
          - 021-018
          - 021-019
          - 021-020
          - 021-021
          - 021-022
          - 021-023
          - 021-024
          - 021-025
          - 021-026
          - 021-027
          - 021-028
          - 021-029
          - 021-030
          - 021-031
          - 021-032
          - 021-033
          - 021-034
          - 021-035
          - 021-036
          - 021-037
          - 021-038
          - 021-039
          - 021-040
          - 021-041
          - 021-042
          - 021-043
          - 021-044
          - 021-045
          - 021-046
          - 021-047
          - 021-048
          - 021-049
          - 021-050
          - 021-051
          - 021-052
          - 022-001
          - 024-001
          - 024-002
          - 024-003
          - 024-004
          - 024-005
          - 024-006
          - 024-007
          - 024-008
          - 025-002
          - 025-003
          - 025-004
          - 025-005
          - 025-006
          - 025-007
          - 025-008
          - 025-009
          - 025-010
          - 025-011
          - 025-012
          - 025-013
          - 025-014
          - 025-015
          - 025-016
          - 025-017
          - 025-018
          - 025-019
          - 025-020
          - 025-021
          - 025-022
          - 021-053
          - 021-054
          - 021-055
          - 021-056
          - 021-057
          - 021-058
          - 021-059
          - 021-060
          - 021-061
          - 021-062
          - 021-065
          - 021-066
          - 021-067
          - 021-068
          - 026-001
          - 026-002
          - 026-003
          - 026-004
          - 026-005
          - 026-006
          - 026-007
          - 026-008
          - 026-009
          - 026-016
          - 026-017
          - 026-018
          - 026-019
          - 026-020
          - 027-001
          - 027-002
          - 027-003
          - 027-004
          - 027-005
          - 027-006
          - 027-007
          - 027-008
          - 027-009
          - 027-010
          - 027-011
          - 027-012
          - 027-013
          - 027-014
          - 028-001
          - 028-002
          - 029-001
          - 029-002
          - 029-003
          - 029-004
          - 029-005
          - 029-006
          - 029-007
          - 029-008
          - 029-009
          - 029-010
          - 029-011
          - 029-012
          - 029-013
          - 029-014
          - 029-015
        message:
          description: Human-readable error detail. An array of per-field messages for validation failures, a single string otherwise.
          oneOf:
          - type: string
          - type: array
            items:
              type: string
        statusCode:
          type: number
          description: The HTTP status code, present on validation failures.
        error:
          type: string
          description: The HTTP status text, present on validation failures.
      required:
      - code
      - message
    UpdatePersonalAlertContactDto:
      type: object
      properties:
        friendlyName:
          type: string
          description: Display name of the personal alert contact
          example: My work email
        enableNotificationsFor:
          enum:
          - 0
          - 1
          - 2
          - 3
          type: number
          description: Which monitor events this contact is notified for
        sslExpirationReminder:
          type: boolean
          description: Whether to send SSL certificate expiration reminders
        isActive:
          type: boolean
          description: Activate (true) or pause (false) the alert contact
    CreatePersonalAlertContactDto:
      type: object
      properties:
        type:
          enum:
          - Email
          - ProSms
          - Voice
          - MobileAppIOS
          - MobileAppAndroid
          - MobileAppOld
          - MobileApp
          type: string
          description: '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:
          type: string
          description: Display name of the alert contact
        enableNotificationsFor:
          enum:
          - 0
          - 1
          - 2
          - 3
          type: number
        value:
          type: string
          description: Email address (required for Email contacts)
        deviceName:
          type: string
          description: Device name (push)
        oneSignalSubscriptionId:
          type: string
          description: OneSignal subscription ID (push)
        oneSignalUserId:
          type: string
          description: OneSignal user ID (push)
        deviceFingerprint:
          type: string
          description: Device fingerprint (push)
        pushToken:
          type: string
          description: Push notification token (push)
        platform:
          type: string
          enum:
          - ios
          - android
          description: Device platform (push)
        config:
          $ref: '#/components/schemas/AlertContactConfigDto'
      required:
      - type
    AlertContactConfigDto:
      type: object
      properties:
        android_push_up_channel:
          type: string
        android_push_down_channel:
          type: string
    AlertContactPaginationDto:
      type: object
      properties:
        nextLink:
          type:
          - string
          - 'null'
        data:
          type: array
          items:
            description: AlertContactPublic
            type: object
            properties:
              id:
                type: number
              friendlyName:
                type:
                - string
                - 'null'
              type:
                description: Alert-contact type. Mobile push responses retain MobileAppOld (iOS) and MobileApp (Android) through October 10, 2026; consumers should also accept MobileAppIOS and MobileAppAndroid before responses switch to those canonical names after the deadline.
              value:
                type:
                - string
                - 'null'
              customValue:
                type:
                - string
                - 'null'
              enableNotificationsFor: {}
              sslExpirationReminder:
                type:
                - boolean
                - 'null'
              httpUsername:
                type:
                - string
                - 'null'
              httpPassword:
                type:
                - string
                - 'null'
              authType:
                type:
                - boolean
                - 'null'
              customHeaders:
                type:
                - object
                - 'null'
                additionalProperties:
                  type: string
              mobileProviderId:
                type:
                - number
                - 'null'
              status: {}
              orgAlertContactId:
                type:
                - number
                - 'null'
              config:
                type:
                - object
                - 'null'
                properties:
                  android_push_up_channel:
                    type: string
                  android_push_down_channel:
                    type: string
            required:
            - id
            - friendlyName
            - type
            - value
            - customValue
            - enableNotificationsFor
            - sslExpirationReminder
            - httpUsername
            - httpPassword
            - authType
            - mobileProviderId
            - status
            - orgAlertContactId
      required:
      - nextLink
      - data
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Enter your API token (without the "Bearer" prefix — it is added automatically).