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

# Send email using Mailgun

> Learn how to send an email using Vuemail and the Mailgun JavaScript SDK.

## 1. Install dependencies

Get the [@vuemaildev/vuemail](https://www.npmjs.com/package/@vuemaildev/vuemail), [mailgun.js](https://www.npmjs.com/package/mailgun.js), and [form-data](https://www.npmjs.com/package/form-data) packages.

```sh npm theme={null}
npm install mailgun.js form-data @vuemaildev/vuemail
```

```sh yarn theme={null}
yarn add mailgun.js form-data @vuemaildev/vuemail
```

```sh pnpm theme={null}
pnpm add mailgun.js form-data @vuemaildev/vuemail
```

## 2. Create an email using Vue

Start by building your email template in a `.vue` file.

```vue email.vue theme={null}
<script setup lang="ts">
import { Button, Html } from '@vuemaildev/vuemail';

const { url } = defineProps<{ url: string }>();
</script>

<template>
  <Html lang="en">
    <Button :href="url">Click me</Button>
  </Html>
</template>
```

## 3. Convert to HTML and send email

Import the email template you just built, convert it into an HTML string, and use the Mailgun SDK to send it.

```ts theme={null}
import { render } from '@vuemaildev/vuemail';
import FormData from 'form-data';
import Mailgun from 'mailgun.js';
import Email from './email.vue';

const mailgun = new Mailgun(FormData);
const client = mailgun.client({
  username: 'api',
  key: process.env.MAILGUN_API_KEY,
});

const emailHtml = await render(Email, { url: 'https://example.com' });

await client.messages.create(process.env.MAILGUN_DOMAIN, {
  from: 'you@example.com',
  to: ['user@gmail.com'],
  subject: 'hello world',
  html: emailHtml,
});
```

## Try it yourself

> **[Mailgun example](https://github.com/psycarlo/vuemail/tree/main/examples/mailgun)**
>
> See the full source code.


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