---
title: "Email the invoice to the customer, from your business name"
method: POST
path: "/api/v1/invoices/{id}/send"
tags: ["invoices"]
---

# Email the invoice to the customer, from your business name

`POST /api/v1/invoices/{id}/send`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/v1/invoices/{id}/send`
- Auth: HTTP bearer

Sends again on a later call, so it is also the reminder, but at most once a minute: a second send within a minute, at the same time or as a retry, emails nothing and answers 409 invoice_recently_sent. Replies go to your account email.

## Path parameters

- `id` string, required

## Response `200`

Sent. `last_sent_at` says when.

- Invoice
  - `id` string, required
  - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible', required
  - `amount` integer, required: Total, in cents.
  - `amount_paid` integer
  - `amount_remaining` integer
  - `currency` string, required
  - `url` string, nullable, required: Stripe’s hosted invoice page, where the customer pays.
  - `pdf_url` string, nullable
  - `number` string, nullable
  - `description` string, nullable
  - `customer` object
    - `email` string, nullable
    - `phone` string, nullable
    - `name` string, nullable
  - `line_items` object[]
    - `description` string, nullable
    - `quantity` integer
    - `unit_amount` integer, nullable
    - `amount` integer
  - `due_date` string, date-time, nullable
  - `created` string, date-time, required
  - `paid_at` string, date-time, nullable
  - `voided_at` string, date-time, nullable
  - `last_sent_at` string, date-time, nullable
  - `orgo_fee` integer: Orgo’s fee in cents: Stripe’s card and Invoicing fees.
  - `payout` integer: What reaches your bank when it is paid, in cents.
  - `workspace_id` string, uuid, nullable
  - `metadata` object

## Other responses

- `401`: Unauthenticated.
- `404`: Not one of your invoices (invoice_not_found).
- `409`: Already paid (invoice_paid), void (invoice_void), the customer has no email (no_customer_email, with `url` to share yourself), or it was emailed less than a minute ago (invoice_recently_sent, with `last_sent_at`).
- `429`: Over one of the account's rate limits (rate_limited): `limit` names it, `retry_after` and Retry-After say how many seconds to wait. Limits are per account (the workspace owner when the request acts on a computer or a workspace) and set by its plan (x-rate-limits).
- `502`: The email did not send (email_failed, with `url`). The invoice is still open, and you can send again at once.
- `503`: Invoicing is not available yet (invoicing_unavailable).

## Changes

- **2026-10-30** `afb6f0ee1aac`: 1 info
  - added the non-success response with the status `429`
- **2026-10-09** `41babeff7892`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/v1/invoices/:id/send/post.md)

---

[API](https://skmtc.dev/orgo/apis/orgo-api.md) - [All operations](https://skmtc.dev/orgo/apis/orgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orgo/apis/orgo-api/revisions/e4c1e7379fa5?raw)