# Resend + Elixir

```elixir
Mix.install([
  {:resend, "~> 0.4.0"},
  {:kino, "~> 0.9.4"}
])
```

## Create a client

To start using Resend, create a `client` with the API key you created in your web dashboard:

```elixir
client = Resend.client(api_key: System.fetch_env!("LB_RESEND_KEY"))
```

Note that if you choose to configure Resend in your app config, passing a client struct is always optional.

## Sending email

We've created some inputs to make sending emails easy. Feel free to replace these as needed!

```elixir
to = Kino.Input.text("To") |> Kino.render()
from = Kino.Input.text("From", default: "onboarding@resend.dev") |> Kino.render()
subject = Kino.Input.text("Subject", default: "Hello World") |> Kino.render()
text = Kino.Input.textarea("Text", default: "It works!") |> Kino.render()

Kino.nothing()
```

Read the input values and send our first email with Resend:

```elixir
{:ok, email} =
  Resend.Emails.send(
    client,
    %{
      to: Kino.Input.read(to),
      from: Kino.Input.read(from),
      subject: Kino.Input.read(subject),
      text: Kino.Input.read(text)
    }
  )
```

We can get details about this email by looking it up with its ID:

```elixir
Resend.Emails.get(client, email.id)
```

## Managing domains

Lets create a new domain, we'll just use a random string:

```elixir
{:ok, domain} =
  Resend.Domains.create(
    client,
    name: Base.encode16(:rand.bytes(8), case: :lower) <> ".com"
  )
```

We can list all our domains, to see that our new one has been added:

```elixir
Resend.Domains.list(client)
```

Now that we've demonstrated that we can create domains, lets remove the random one we created:

```elixir
{:ok, _deleted} = Resend.Domains.remove(client, domain.id)
```

## Managing API keys

We can manage API keys too. Let's create a new one that can only send to our new domain. Note that we must also apply the `"sending_access"` permission when specifying a `:domain_id`.

```elixir
{:ok, api_key} =
  Resend.ApiKeys.create(client,
    name: "For random domain",
    permission: "sending_access",
    domain_id: domain.id
  )
```

The `:token` field we get back contains our new API token. It's the only time it's show, so make sure to save it some place where it won't get lost.

Let's take a look at our new API key in the list of all API keys:

```elixir
Resend.ApiKeys.list(client)
```

Nice!

Lastly, we'll remove the API key we created to keep our account nice and tidy:

```elixir
{:ok, _deleted} = Resend.ApiKeys.remove(client, api_key.id)
```

<!-- livebook:{"offset":2511,"stamp":{"token":"QTEyOEdDTQ.SkeVKU3HxgWf9NDYfZ00hmmfkmRM-H3OSfb8rTM0VVcvsJqIXvKjw0FUeyo.A1Vah4do4eSa7x77.oFpWBoAZHs_1s0lh7EKMJuuU2BSddg0DAnX-X9EG6NrzzonSsXZT-no1zHh_sA.tapBdO4vJH3QxEO0Y4B1Iw","version":1}} -->