Entri Monitor allows you to monitor your customer’s domains for any DNS changes.
monitor: true
property in either the domain object or each record object to specify that it should be tracked with Entri Monitor.
Monitor everything:
applicationId
: Your unique application ID.
Authorization
: A bearer token generated using your client secret.
POST
request to /monitor/domains
with the name of the domain, as well as a list of the records you want to monitor, including their type
, host
, value
, and ttl
properties.
Example request body:
/monitor/domains/:domain_name/records
Description: Fetch all monitored DNS records for a specific domain.
Headers:
applicationId
: Your application ID (required).
Authorization
: Bearer token (required).
domain_name
(string, required): The domain to retrieve records for./monitor/domains/:domain_name/records
Description: Add new DNS records to be monitored on an existing domain.
Request Body:
dnsRecords
(array, required): List of DNS records to add.
type
(string, required): Record type (e.g., A
, CNAME
).
host
(string, required): Hostname.
value
(string, required): Record value.
ttl
(integer, required): Time-to-live in seconds.
priority
(string, only MX record): Record priority when multiple MX records are found.
/monitor/domains/:domain_name/records
Description: Update DNS records for a monitored domain.
Request Body:
/monitor/domains/:domain_name/records
Description: Remove specific DNS records from the monitoring for a domain.
Request Body:
/monitor/domains
Query Parameters:
offset
(integer): Pagination offset.
limit
(integer): Number of domains per page.
from_date
(date): Filter start date.
to_date
(date): Filter end date.
/monitor/domains/:domain_name
Description: Get all the settings for a specific monitored domain.
Response Example:
/monitor/domains
Description: Add a domain for monitoring.
Request Body:
/monitor/domains
Description: Update details for an existing domain.
Request Body:
/monitor/domains
Description: Remove a domain from monitoring.
Request Body:
/monitor/domains/batch
Description: Add multiple domains in a single request. A maximum of 100 domains can be sent per request.
Request Body:
/monitor/domains/batch/status/:request_id
Description: Check the status of a batch operation.
Response Example:
id
: A unique identifier for the webhook event (e.g. "e98d267b-84b8-4229-a94a-1933ed7f91ea"
).user_id
: The ID of the user who initiated the domain-related action (e.g. "your-provided-user-id"
).domain
: The domain involved in the event (e.g. "example.com"
).subdomain
: The subdomain associated with the event, if any (e.g. "shop"
).type
: Defines the type of event. Possible values:
"domain.record_missing"
: Used whenever there is a record missing from the records that are being monitored."domain.record_restored"
: Confirms that ALL records have been restored.data.records_propagated
: Contains all the records that are being monitored and were found correctly configured on the domain.data.records_non_propagated
: Contains all the records that are being monitored and were found as missing on the domain.connect_link
: Entri Connect’s sharing link with the configuration required to restablish the missing records on the domain.