Bulk Import Tool | Use and Fields

The Bulk Import system is designed to provide a simple template that allows for efficient creation of many checks in a single action. We recommend that users download the Bulk Upload Excel Template, which provides a sample of the data format that is accepted by Uptime.com.


The Bulk Import system can accept up to 200 checks simultaneously. For values higher than 200, please upload a separate Excel sheet following the Bulk Upload format.

All Bulk Upload Checks are available via download as XLS files for review and editing.

Bulk Import Fields Defined

Each field tells Uptime.com something specific about the check you’re creating. Here are some detailed explanations to help users find the required parameters for their specific check. You can see an example of some values within this sheet below:



The Check Type. The Excel sheet provided includes a dropdown list with each Check Type available through Uptime.com.


An optional parameter. Name is used to identify your check with a custom name that you designate.


Designate the frequency in which the check is run. Checks run at a one-minute Interval are not available to free accounts.


Contacts refers to the name(s) of the contacts to alert if a check fails. You can specify multiple contacts separated by commas, eg: Default, Emergency, or IT Admin. Default will issue alerts to the email address used to create your Uptime.com account.


A list of locations to run the checks from, separated by commas. For example, US-East, UK. You may leave this blank to run the check from all locations. See the Probe Servers page for a full list of locations. NOTE: To avoid false positives, use a minimum of three locations and set Sensitivity to 2 or more.


For HTTP/HTTPS checks, Address refers to the full URL of the page to check. For specific pages, please designate the full URL and not merely the domain. For all other checks, Address is the domain name or IP address of the server to check.


Designate which Port on the server Uptime.com should monitor. You may leave this blank if you use the standard ports (eg. port 80 for HTTP).


For HTTP/HTTPS checks, this optional Username is for Basic Authentication. For SMTP checks, the optional username parameter is used to login to the server.


For HTTP/HTTPS checks this field determines the checker version used. Input value 1 for V1.0 Legacy and value 2 for V2.0 Curl which supports SSL/TLS certificate verification.


This is the accompanying Password to be used with username above.


For DNS checks only, this cell represents the domain name or IP address of the DNS Server to query.


For DNS checks only, this cell represents the DNS Record Type to query and verify. (Uptime.com can check for: ANY, A, AAAA, CNAME, MX, NS, PTR, SOA or TXT). Please refer to our DNS Check Basics article for additional information.


For HTTP/HTTPS checks, this cell should include an optional URL-encoded string to POST to the provided URL. For TCP/UDP checks, the data to send to the server after connecting.


If provided, the check ensures that the response from the server includes the text in this cell. Not used for ICMP or SSH checks.


For HTTP/HTTPS checks, this cell describes the kind of string to expect. Will alwyas be one of the following: STRING - plain text string, REGEX - regular expression, INVERSE_REGEX - check fails if regular expression is matched.


Encryption applies to SMTP, POP, and IMAP checks only. This cell specifies whether to use SSL/TLS encryption when connecting to the mail server. Select the correct value from the drop-down list.


The alert Threshold refers to the response time or page load time when applied to HTTP, Transaction, API and RUM checks. For WHOIS/SSL certificate checks, this cell specifies how many days before domain/certificate expiry to raise an alert.


This cell sends the Protocol-specific message(s) to switch to TLS for communication SSL checks. Protocol is a keyword for the intended protocol. Currently, the only supported keywords are "http" (default for HTTPS connections), "smtp", "pop3", "imap", "ftp", "xmpp", "irc", and "ldap".


Headers specify what headers to send with each request for HTTP checks. Headers must be written in the following format: Name: Value, with one entry per line.


Script is used for Transaction checks, specifying the JSON script that defines the entire transaction. This is an advanced feature, and we suggest you use the transaction editor on the checks page instead. Please also refer to our Transaction Checks Basics support article for more information.


Sensitivity defines the number of Locations that must be down before an alert is sent. This value defaults to 2 because we recommend a minimum of three locations, with a Sensitivity of two failures in order to avoid false positives.


Specifies whether to use IPv4, IPv6 or any available address of the target host. Possible values are: IPV4 or IPV6. Leave this cell blank to use any available IP version.


Defines the minimum availability percentage the check needs to meet, Values rounded up to 2 decimal places.


Determines the minimum average SLA Response Time (in seconds). Value can be entered up to 3 decimal places.


Free text available for any check. Use this space to include any information for your reference, such as error recovery instructions your team should follow.

Was this article helpful?
1 out of 4 found this helpful