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/startIngestingRequest
| Field | Type | Description |
|---|---|---|
email | string | Email address for the trial workspace. An activation link will be sent here. |
serviceName | string | Name for the service that will receive the alerts. |
source | string | Monitoring 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
| Status | Description |
|---|---|
200 | Trial workspace created. Ingestion URL returned and activation email sent. |
403 | Captcha verification failed. Please try again. |
409 | An organization with this email domain already exists. |
422 | Validation error: invalid source (allowed: webhook, new_relic, datadog, cloudwatch, prometheus, grafana) or disposable email domain. |
429 | Too many requests for this email. Please wait 30 minutes. |
500 | Unexpected 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.