---
title: "Send invoice email"
description: "Send (or resend) the invoice email to the customer. Optionally specify a template for the PDF attachment."
url: https://docs.invoicefalcon.com/api/email/send-invoice-email/
api: "API v1 reference"
method: POST
path: "/invoices/{slug}/send_email"
---

# Send invoice email

`POST https://app.invoicefalcon.com/api/v1/external/invoices/{slug}/send_email`

Send (or resend) the invoice email to the customer. Optionally specify a template for the PDF attachment.

## Path parameters

- `slug` (string, required): The invoice's unique slug (UUID).

## Request body

- `template_id` (integer): Optional template ID for the PDF attachment.

## Returns

- `message` (string): e.g. `Email queued for delivery`

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/docs/rate-limiting/)).

## Example request

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices/{slug}/send_email" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Email queued for delivery"
  }'
```

## 200

Email queued for delivery.

```json
{
  "message": "Email queued for delivery"
}
```

## 401

Missing or invalid API key.

```json
{
  "error": "Invalid API key"
}
```

## 403

The store is not on a paid plan. API access requires a paid Invoice Falcon plan.

```json
{
  "error": "REST API access requires a paid plan"
}
```

## 404

Resource not found.

```json
{
  "error": "Not found"
}
```

## 422

Request could not be processed.

```json
{
  "error": "param is missing or the value is empty: customer",
  "errors": {}
}
```

## 429

Rate limit exceeded. Check `X-RateLimit-Reset` header.

```json
{
  "error": "Rate limit exceeded",
  "retry_after": 30,
  "message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 30 second(s)."
}
```

