---
title: SendGrid
description: Send email through the SendGrid v3 API.
icon: Truck
source: "src/transports/sendgrid.ts"
---

Send email through the SendGrid v3 API.

<Callout title="The one rule">Create this transport under the matching sently channel sender.</Callout>

## Configuration

| Option | Type | Default or requirement |
| --- | --- | --- |
| `apiKey` | `string` | required |

<Steps>
  <Step title="Configure the transport">

```ts
import { createMailer } from "sently/mailer";
import { SendGridTransport } from "sently/transports/sendgrid";

const sender = createMailer({ transport: new SendGridTransport({ apiKey: process.env.SENDGRID_API_KEY! }) });
```

  </Step>
  <Step title="Send with the channel API">

```ts
await sender.send({ from: "hello@example.com", to: "person@example.com", subject: "Hello", text: "Hi" });
```

  </Step>
</Steps>

<Accordions><Accordion title="Should I call the provider SDK?">No. Use the sently sender; provider-specific extras stay on the transport instance.</Accordion></Accordions>

<Cards><Card title="Email channel" href="/docs/channels/email" /></Cards>