# Email Integration {#email-integration}


Email configuration for notifications, invitations, and transactional messages.


## Email Providers {#email-providers}


| Provider     | Configuration        |
| ------------ | -------------------- |
| **SMTP**     | Standard SMTP server |
| **SendGrid** | SendGrid API         |
| **Mailgun**  | Mailgun API          |


## Configuration {#configuration}



### SMTP {#smtp}


```bash
MAIL_FROM_ADDRESS=noreply@yourdomain.com
MAIL_HOST=smtp.yourdomain.com
MAIL_PORT=587
MAIL_USERNAME=your-email@yourdomain.com
MAIL_PASSWORD=your-email-password
```


### SendGrid {#sendgrid}


```bash
MAIL_FROM_ADDRESS=noreply@yourdomain.com
SENDGRID_API_KEY=SG.your-sendgrid-api-key
```


## Transactional Emails {#transactional-emails}


| Email                  | Trigger                   |
| ---------------------- | ------------------------- |
| **Welcome**            | User registration         |
| **Email Verification** | Account creation          |
| **Password Reset**     | Password reset request    |
| **Invitation**         | Employee/user invite      |
| **Timesheet Reminder** | Timesheet submission due  |
| **Timesheet Approved** | Timesheet approved        |
| **Invoice Sent**       | Invoice emailed to client |


## Email Templates {#email-templates}


Templates are located in the API assets directory:

```
packages/core/src/lib/email-template/
├── templates/
│   ├── welcome/
│   ├── invite/
│   ├── password-reset/
│   ├── email-verification/
│   └── invoice/
```

Templates support:

- **Handlebars** syntax for dynamic content
- **Organization branding** (logo, colors)
- **Multi-language** support


## Related Pages {#related-pages}


- [Integrations Overview](https://sourcey-gauzy.pages.dev/integrations/integrations-overview/index.md)
- [Registration & Onboarding](https://sourcey-gauzy.pages.dev/authentication/registration-and-onboarding/index.md)