Skip to content

Start alert ingestion ​

Set up a trial workspace with a pre-configured integration for your monitoring tool. The response contains a ready-to-use ingestion webhook URL you can paste directly into your tool.

POST/v1/quickstart/startIngesting

Request ​

FieldTypeDescription
emailstringEmail address for the trial workspace. An activation link will be sent here.
serviceNamestringName for the service that will receive the alerts.
sourcestringMonitoring tool to integrate with. One of: webhook, cloudwatch, datadog, prometheus, grafana, new_relic.
turnstile_tokenstringCloudflare Turnstile challenge token.

Example ​

{
  "email": "dev@acme.com",
  "serviceName": "backend-api",
  "source": "datadog",
  "turnstile_token": "0.abc123"
}

Or using curl:

bash
curl -X POST https://api.navi.sh/v1/quickstart/startIngesting \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "turnstile_token": "0.abc123...",
    "serviceName": "production-api",
    "source": "datadog"
  }'

Response ​

StatusDescription
200Trial workspace created. Ingestion URL returned and activation email sent.
403Captcha verification failed. Please try again.
409An organization with this email domain already exists.
422Validation error: invalid source (allowed: webhook, new_relic, datadog, cloudwatch, prometheus, grafana) or disposable email domain.
429Too many requests for this email. Please wait 30 minutes.
500Unexpected server error.

On success:

{
  "message": "Check your email to access your dashboard.",
  "status": "ok",
  "url_for_ingestion": "https://api.navi.sh/v1/events/datadog/tok_abc123"
}

Copy the url_for_ingestion value and paste it as the webhook destination in your tool's settings. See the Integrations section for tool-specific setup guides.

Built by the Navi.sh team.