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.

Example

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

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.