Skip to main content

Contacts

As a monitoring service, Uptimia sends notifications to your email, phone number, Slack account, WhatsApp account, and other channels when we detect issues with any website or service you are monitoring. This article will explain how the alerting system and various contact options work.

At Uptimia, we categorize contacts into three groups:

Individual Contacts​

These are contact methods linked to your own or a team member's account, like email addresses, phone numbers, or Slack integrations. You can assign individual contacts to receive alerts in case of an incident. For more information on contacts, refer to our documentation here.

Users​

Assigning a user means that all the contacts associated with that user's account will be alerted when an incident occurs. For more details about users, please check our documentation here.

Teams​

Assigning a team means that all the contacts within each team member's account will receive alerts in the event of an incident. You can find more information about teams in our documentation here.

Let us illustrate how assigning contacts works in our web version of Uptimia with the following example:

How to assign contacts

In this example, an individual contact (an email address) is chosen to receive notifications. Selecting the team (DevOps) would send alerts to all team members. If you choose the user (Uptimia Demo), alerts will be sent to all individual contacts associated with that user.

How to assign contacts with the API​

tip

Please keep in mind that this tutorial is intended for advanced users. If you want to receive notifications for all of your assigned contacts across all users in your account, please leave the contacts field empty.

We will guide you through the process of assigning various types of contacts using the Uptimia API.

Each contact includes the following fields:

  • id: The unique ID of a contact, a user or a team
  • is_team: True if a contact is a team
  • is_user: True if a contact is an account owner
  • is_operator: True if contact is a team member
  • is_individual_contact: True if contact is an individual contact outside of a team or a user

Individual contacts​

This is an example of an individual contact:

{
    id: 1,
    is_team: 0,
    is_user: 0,
    is_operator: 0,
    is_individual_contact: 1
}

You can get a list of contacts associated with your Uptimia account here.

Users​

This is an example of a user:

{
    id: 2,
    is_team: 0,
    is_user: 1,
    is_operator: 0,
    is_individual_contact: 0
}

You can get a list of users associated with your Uptimia account here.

info

Please note that the owner of the account (the user who created the account) must be defined as "is_user" and all other team members as "is_operator".

Teams​

This is an example of a team:

{
    id: 3,
    is_team: 1,
    is_user: 0,
    is_operator: 0,
    is_individual_contact: 0
}

You can get a list of teams associated with your Uptimia account here.

Examples​

Here is an example of a JSON array of objects with the following configuration:

  • 1 team
  • 1 user
  • 1 individual contact
[{
    id: 1,
    is_team: 1,
    is_user: 0,
    is_operator: 0,
    is_individual_contact: 0
},
{
    id: 2,
    is_team: 0,
    is_user: 1,
    is_operator: 0,
    is_individual_contact: 0
},
{
    id: 3,
    is_team: 0,
    is_user: 0,
    is_operator: 0,
    is_individual_contact: 1
}]