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

# Notifications

> Templates and delivery configuration for automated messages.

Notification templates let you customize the messaging customers receive when events happen in the system. You control the verbiage, formatting, and what details are included in each notification.

## Channels

Notifications can be delivered through three channels, but channel availability varies by event:

| Channel | Description                      | Requirements                                            |
| ------- | -------------------------------- | ------------------------------------------------------- |
| Email   | Sent via SendGrid                | [SendGrid integration](/features/integrations#sendgrid) |
| SMS     | Sent via Twilio                  | [Twilio integration](/features/integrations#twilio)     |
| In-App  | Displayed in the customer portal | None                                                    |

Each channel has its own template, so you can tailor the message format and length appropriately—detailed HTML emails, concise text messages, and quick in-app alerts.

Some events are email-only. For example, account archive/restore and payment success/failure notifications do not currently support SMS or in-app delivery.

## Notification events

Templates are available for the following events:

| Event                | Description                                          |
| -------------------- | ---------------------------------------------------- |
| Lead Assigned        | A lead is assigned to a customer                     |
| Outbid               | Customer's bid is outbid by another customer         |
| Bid Matched          | Another customer matches the bid amount              |
| Buy Order Exceeded   | Customer's buy order is exceeded by another          |
| Buy Order Reinstated | Customer's buy order becomes the highest bid again   |
| Account Paused       | Customer's account is paused                         |
| Account Unpaused     | Customer's account is unpaused                       |
| Account Archived     | Customer's account is archived                       |
| Account Restored     | Customer's account is restored from archive          |
| Return Approved      | Customer's return is approved                        |
| Return Tier Updated  | Customer's return tier changes                       |
| Payment Failed       | A payment transaction fails                          |
| Payment Successful   | A payment processes successfully                     |
| Under Funded Bids    | Customer has bids limited by their available balance |

## Template variables

Templates support merge fields using double curly braces: `{{ variable_name }}`. Available variables depend on the notification type.

### Common variables

These are available in all templates:

* `{{ actionLink }}` - URL to the relevant page
* `{{ defaultActionText }}` - Default text for the action button
* `{{ supportEmail }}` - Your tenant's support email

### Lead variables

Available for lead-related notifications (Lead Assigned, Outbid, Bid Matched, Return Approved):

* `{{ lead.public_id }}`, `{{ lead.uuid }}`
* `{{ lead.full_name }}`, `{{ lead.first_name }}`, `{{ lead.last_name }}`
* `{{ lead.email }}`, `{{ lead.phone }}`
* `{{ lead.address_1 }}`, `{{ lead.address_2 }}`, `{{ lead.city }}`
* `{{ lead.leadType.name }}`
* `{{ lead.details.field_name }}` - Any custom field on the lead category

### Customer variables

Available for customer-related notifications:

* `{{ customer.name }}`, `{{ customer.email }}`, `{{ customer.phone }}`
* `{{ customer.address }}`, `{{ customer.city }}`, `{{ customer.state }}`, `{{ customer.zip }}`
* `{{ customer.leads_count }}` - For batch notifications

### Other variables

* **Buy order notifications**: `{{ buyOrder.amount }}`, `{{ buyOrder.scope }}`, `{{ buyOrder.status }}`
* **Return tier notifications**: `{{ disputeTier.name }}`, `{{ disputeTier.discount_percentage }}`, `{{ disputeTier.penalty_percentage }}`

## Editing templates

Each notification type has separate templates for each channel. When editing:

* **Email**: Supports rich text formatting (bold, italic, underline, strikethrough)
* **SMS**: Plain text only—keep it concise
* **In-App**: Supports basic formatting

Templates are validated when you save to ensure all variables are valid for that notification type. If you reference a variable that doesn't exist, you'll see an error.

You can reset any template to its default at any time.

## Related guides

<Card title="Customizing notification templates" icon="bell" href="/guides/customizing-notification-templates" horizontal>
  Rewrite the email, SMS, and in-app messages Juiced sends customers.
</Card>