Integration

REST API for Domain Monitoring

Manage your watchlist from code. Add a domain, remove a domain, list domains, pull change history, or trigger an on-demand refresh. The API pairs with webhooks so your system can both push changes and react to them.

Setup

  1. 1

    Generate an API token

    In Integrations, click Create API token. Give it a label (so you can revoke it later) and copy the token. It is shown only once.

  2. 2

    Call the API

    Send Authorization: Bearer YOUR_TOKEN with every request. Base URL is https://notify.domains/api/v1/. All responses are JSON.

  3. 3

    Combine with webhooks

    Use the API to push domains in; use webhooks to get events out. Together they form a complete automation loop for large portfolios.

Example payload

This is exactly what the webhook body looks like. Use it to build your downstream logic.

# Add a domain to your watchlist
curl -X POST https://notify.domains/api/v1/domains \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","notes":"target for Q3"}'

# List your watched domains
curl https://notify.domains/api/v1/domains \
  -H "Authorization: Bearer YOUR_TOKEN"

# Get change history for a domain
curl https://notify.domains/api/v1/domains/example.com/history \
  -H "Authorization: Bearer YOUR_TOKEN"

What you get

Bearer-token auth

One token per integration. Revocable from your dashboard. Rotate without downtime.

Full CRUD on domains

Add, update, remove, and list watched domains. Attach notes and labels. Bulk operations supported.

History endpoint

Pull every detected change for any domain. Filter by event type, date range, or field.

Paired webhooks

Use the API to push state in, webhooks to get events out. One loop, end to end.

Rate limits you can live with

Per-token rate limits that fit real automation. If your use case needs more, reach out.

Frequently asked questions

Is there an OpenAPI spec?
Yes. The spec is in your dashboard under Integrations / API. You can import it into Postman, Insomnia, or an OpenAPI client generator.

Can I have multiple tokens?
Yes. Create one per integration so you can revoke independently. Each token has the same permissions as your account.

Can I use the API to bulk-import a portfolio?
Yes. The add-domain endpoint accepts single and batch requests. For very large portfolios (1000+ domains), reach out so we can suggest a smoother path.

Other integrations

Webhooks for Domain Alerts

Receive JSON payloads for every domain event on an HTTPS endpoint you own. Optional HMAC signing, per-domain on/off, delivered in seconds.

n8n Integration for Domain Alerts

Pipe Notify.domains events into n8n workflows with one webhook URL. Open-source friendly, self-hosted or cloud, optional HMAC signing.

Zapier Integration for Domain Alerts

Connect Notify.domains to Zapier with a single webhook URL. Trigger downstream actions when a watched domain changes status, goes to auction, or gets listed.