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 the monitor's Alerting section you choose who gets notified. You can pick an individual contact (such as an email address), a whole user — which alerts every contact on that user's account — or a team, which alerts all of its members.

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
}]