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

# Free Trial Email Notification

> Send notification email when a Stripe free trial is created

# Free Trial Email Notification

Sends a transactional email to `notifications@searchcompany.ai` via Loops.so when a new Stripe free trial is created.

## Endpoint

```http theme={null}
POST /webhooks/notifications/free-trial-started
```

## Features

* **Async/Non-blocking**: Returns immediately, email sends in background
* **Template ID**: `cmkaghcrr2maf0i035bx000z4`

## Request Body

| Field        | Type   | Required | Description                                 |
| ------------ | ------ | -------- | ------------------------------------------- |
| `user_email` | string | Yes      | Email of the user                           |
| `user_name`  | string | No       | Name of the user                            |
| `org_name`   | string | No       | Organization name                           |
| `org_slug`   | string | No       | Organization slug                           |
| `plan_name`  | string | No       | Name of the plan (defaults to "Free Trial") |

## Example Request

```json theme={null}
{
  "user_email": "newuser@example.com",
  "user_name": "John Doe",
  "org_name": "Acme Corp",
  "org_slug": "acme-corp-123456",
  "plan_name": "Pro Plan"
}
```

## Example Response

```json theme={null}
{
  "status": "queued",
  "message": "Free trial started notification queued",
  "template_id": "cmkaghcrr2maf0i035bx000z4"
}
```

## Internal Usage

```python theme={null}
from src.app.webhooks.notifications.routes import notify_trial_started

await notify_trial_started(
    user_email="user@example.com",
    user_name="John Doe",
    org_name="Acme Corp",
    org_slug="acme-corp-123456",
    plan_name="Pro Plan"
)
```