> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenash.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Nash exposes two MCP servers. The docs MCP server at https://docs.usenash.com/mcp searches this documentation and needs no credentials. The Nash MCP server at https://mcp.usenash.com/mcp operates an organization's deliveries and needs a Nash API key. See https://docs.usenash.com/reference/build-with-ai.
> Use the Sandbox environment (https://api.sandbox.usenash.com/v1) for anything that creates or dispatches deliveries during development.

# Notifications

> Nash's built-in notifications platform alerts customers and internal teams on delivery events across SMS, email, WhatsApp, Slack, and webhook — with reusable audiences, fine-grained targeting, and customizable messages.

Nash has a built-in, customizable notifications platform that lets you own the end-to-end customer experience and keep internal teams up to speed on delivery events. Every notification separates the **event and message** from the **audience**, so you can send the same update to different audiences — or different messages on the same event — without rebuilding anything. Whether a job (delivery) reaches a new status, a driver runs late, or an order needs attention, you decide who hears about it and how.

## How it works

You manage notifications under **Settings > Notifications** in the Portal, built from three pieces:

* **Triggers** define *when* a notification fires and *what* it says — an event (a status change, a delay, a failed dispatch) paired with a message.
* **Destinations** define *who* receives it and *where* — a reusable audience on one or more channels.
* **Settings** control how messages are sent, including sending SMS from your own number.

Because the event and message live on the trigger and the audience lives on the destination, one event can notify several audiences at once, and one audience can be reused across many events — no duplicated work.

![Notification triggers in the Nash Portal](https://mintcdn.com/nashtechnologies/ym7WiWWZe4DcXwLF/images/screenshots/notif-triggers.png?fit=max\&auto=format\&n=ym7WiWWZe4DcXwLF\&q=85\&s=8d1f01b9cfe107fbfc66960ddcd64769)

## Channels

Notifications can be delivered across multiple channels:

> [card] SMS

> [card] Email

> [card] WhatsApp

> [card] Slack

> [card] Webhook

A single destination can mix channels. Triggers can also hand off to [Nash Agent](https://docs.usenash.com/nash-agent/custom-agents.md) — starting a custom agent to investigate and resolve an issue, or pushing an alert to your team.

## Events you can notify on

Nash ships a broad catalog of triggers, grouped by what they watch:

* **Delivery** — a delivery reaching a new status (*Pickup Complete*, *Dropoff Enroute*, *Dropoff Complete*) — one trigger can watch several statuses at once, so a message that should go out at pickup and again at dropoff is one trigger rather than two — incident reports, task reassignments, a failed auto-dispatch or cancellation, delivery attempts exhausted, a proof-of-delivery photo uploaded, and more.
* **Driver** — a driver's distance or time from pickup or dropoff, entering or leaving a [zone](https://docs.usenash.com/reference/zones.md), a location that doesn't match the reported status, and pickup or dropoff ETAs running late.
* **Status** — a delivery stuck in one status too long, statuses changing faster than expected, and live-monitoring health changes.
* **Order** — an order that needs attention, is ready to fulfill, hasn't dispatched as pickup nears, or has an address that won't validate, plus optimization outcomes and an event you fire yourself from the API. **Order Cutoff Time** runs a set number of minutes after an order's booked [delivery window](https://docs.usenash.com/reference/delivery-windows.md) reaches its cutoff, and moves with the order if it's booked into another window.
* **Refund** — refund requests as they move through review.

By default, your account includes customer-facing SMS notifications on key status transitions — *Pickup Complete*, *Dropoff Enroute*, and *Dropoff Complete* — plus internal notifications such as *Delivery Booked* and *Task Reassigned* that are disabled by default.

> [!NOTE]
>
> For the complete catalog of triggers and the events behind them, see the [notifications catalog](https://docs.usenash.com/api-reference/notifications/notifications.md).

## Discover trigger types from the API

[Get notification trigger catalog](https://docs.usenash.com/api-reference/notifications/get-notification-trigger-catalog.md) (`GET /v1/notification-triggers/catalog`) returns the trigger definitions your integration can use to build notification tooling. Each response includes:

* `triggers`, with each trigger's type, title, entity type, statuses, parameter schema, supported filters, and supported actions
* `filterCriteria`, with the shared fields and operators available for narrowing a trigger
* `actions`, with the action types a trigger can run

The endpoint takes no query parameters. Fetch it when your integration needs to present the current trigger catalog without hard-coding trigger types or their configuration schema.

```bash theme={"dark"}
curl --request GET \
  --url https://api.sandbox.usenash.com/v1/notification-triggers/catalog \
  --header "Authorization: Bearer $NASH_API_KEY" \
  --header "Nash-Org-Id: $NASH_ORG_ID"
```

## Customer notifications and the tracking page

Customer messages typically include a **tracking link** (`{{job_tracking_link}}`) that opens Nash's live-tracking page, where the customer sees the courier's position on a map and real-time status updates. You can embed that same live-tracking experience directly in your own web or mobile app — see [Embedding the Nash live-tracking experience](https://docs.usenash.com/reference/nash-embedding.md).

## Destinations: choose who hears it

A **destination** is a reusable group of recipients. Build as many as you need, mix channels within one, and point any number of triggers at it. Recipients can be:

* **Static** — a specific email address, phone number, Slack channel, or webhook URL.
* **Dynamic** — a variable resolved per delivery, such as `{{customer.phone_number}}` to text the recipient or `{{provider.slack_channel}}` to post in the assigned provider's channel.

Because the message lives on the trigger and the audience on the destination, you can tailor the same event per audience — a detailed Slack message for your ops team and a friendly SMS for the customer. Give each destination its own message override and, for email, its own subject line. You can also limit a trigger to fire **once per job** for a destination, so a chatty event doesn't text a customer over and over.

## Target the right deliveries

Not every trigger should fire on every delivery. Each trigger has an **Advanced** section to narrow when it runs:

* **Dispatch strategies** — only deliveries that use selected [dispatch strategies](https://docs.usenash.com/reference/dispatch-strategies.md).
* **Contracts** — only deliveries on selected contracts.
* **Conditions** — only deliveries whose metadata matches conditions you define, combined with AND/OR. Operators include *equals*, *does not equal*, *greater than*, *less than*, *contains*, *starts with*, and *ends with* — for example, fire only when `priority` equals `high`.

## Flag deliveries for live ops

A trigger can do more than send a message — it can **flag** the delivery so your team works it from the Flagged view in the Portal, turning passive alerts into a live queue. For triggers that watch an ongoing condition — a stuck status, a late pickup, or a late dropoff — enable **auto-resolve** to clear the flag automatically once the delivery recovers, so the queue only shows problems that are still live.

## Customize your messages

Every message supports **dynamic variables** so it reflects the specific delivery. Variables span the customer, pickup, dropoff, job, order, and delivery-provider context — for example `{{customer.first_name}}`, `{{pickup_business_name}}`, `{{dropoff_eta}}`, `{{job_tracking_link}}`, and `{{driver.name}}`. The [notifications catalog](https://docs.usenash.com/api-reference/notifications/notifications.md) lists every variable, and Nash adds to it regularly.

For email, a recipient group on a delivery trigger can **Use a template** in place of the inline subject and message: a designed email from your [email templates](https://docs.usenash.com/reference/email-templates.md) library, sent as its latest published version. The group's contacts on other channels get the trigger's **Message for other channels**. If the template can't render at send time, the email falls back to the trigger's saved inline subject and message.

By default Nash sends SMS from its own messaging service. Your organization can instead send from its own Twilio account and sender identity, so texts arrive from a number your customers recognize — available on the **Settings** tab under Settings > Notifications.

A trigger can also add a **custom event** to the delivery's timeline when it fires — useful for tracking, or to start a [workflow](https://docs.usenash.com/reference/workflows.md).

For richer customer-facing customization — re-skinning the live-tracking page or embedding only selected widgets — see the advanced options in [Embedding the Nash live-tracking experience](https://docs.usenash.com/reference/nash-embedding.md).

## Track what Nash sent

Open any delivery in the Portal and select the **Notifications** view on its timeline to see every message Nash sent for that job — the trigger, the message, where it went, and when — along with any replies that came back. It's the fastest way to confirm a customer was notified.

## Deny list

The **deny list** is how you suppress notifications for a specific contact who has opted out of communications. Each entry records a **type** of communication and the **value** for that type — for example an email address or a phone number — giving you fine-grained, per-contact control over who Nash messages.

**1. Add a contact**

[Add a contact to the deny list](https://docs.usenash.com/api-reference/notifications/add-a-contact-to-the-deny-list.md) (`POST /v1/organization-management/notifications/deny-list`) opts a contact out. Provide the required `type` and `value`; that contact will no longer receive delivery notifications.

**2. Review the list**

[Get contacts in the deny list](https://docs.usenash.com/api-reference/notifications/get-contacts-in-the-deny-list.md) (`GET /v1/organization-management/notifications/deny-list`) returns the suppressed contacts, with `page` / `pageSize` pagination.

**3. Remove a contact**

[Remove a contact from the deny list](https://docs.usenash.com/api-reference/notifications/remove-a-contact-from-the-deny-list.md) (`DELETE /v1/organization-management/notifications/deny-list`) opts the contact back in so they resume receiving notifications.

> [!NOTE]
>
> The deny list operates at the organization level. Adding a contact suppresses Nash-sent notifications for that contact across deliveries, not just a single job.

## Next steps

> [card] [Notifications catalog](https://docs.usenash.com/api-reference/notifications/notifications.md)
>
> Every trigger, channel, and dynamic message variable.

> [card] [Trigger catalog API](https://docs.usenash.com/api-reference/notifications/get-notification-trigger-catalog.md)
>
> Read the current trigger types, filters, actions, and configuration schemas.

> [card] [Add to deny list](https://docs.usenash.com/api-reference/notifications/add-a-contact-to-the-deny-list.md)
>
> Suppress notifications for a contact.

> [card] [Live-tracking embed](https://docs.usenash.com/reference/nash-embedding.md)
>
> Embed the Nash tracking page in your own app.

> [card] [Workflows](https://docs.usenash.com/reference/workflows.md)
>
> Drive automated actions when a trigger fires.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.