---
title: "Send an envelope"
method: POST
path: "/v1/envelopes/{envelope_id}/send"
tags: ["sign"]
---

# Send an envelope

`POST /v1/envelopes/{envelope_id}/send`

## Request

- Base URL: `https://api.noerrands.com/c/sign`
- URL: `https://api.noerrands.com/c/sign/v1/envelopes/{envelope_id}/send`
- Auth: HTTP bearer

Confirm a quote and open the envelope for signing; CONSEQUENTIAL and charged exactly the quoted amount (199 credits per envelope, 99 for a self-sign, the account's first self-sign free). Sensitive write: it requires the human's approval of the signers and that price. Returns one private signing_url per signer. No email is sent by this service: each link reaches its signer only when it is delivered to them, for example from the human's own email connector. Links are shown once; remind_signer issues a fresh one.

## Path parameters

- `envelope_id` string, required: The envelope id, "sg_..." from create_envelope.

## Request body

- object
  - `quote_id` string, required: The quote_id create_envelope returned, which the human approved.

## Response `200`

Success.

- object
  - `envelope_id` string, required
  - `status` 'sent', required
  - `credits_charged_cents` integer, required
  - `balance_cents` integer, required
  - `expires_at` string, date-time, required
  - `signers` object[], required
    - `signer_id` string, required
    - `name` string, required
    - `email` string, required
    - `order` integer, required
    - `signing_url` string, uri, required: This signer's private link. Send it to this signer only. Shown once; remind_signer issues a new one.

## Other responses

- `400`: invalid_request
- `401`: unauthorized. Carries WWW-Authenticate: Bearer resource_metadata="..."
- `402`: insufficient_credits, with required_cents, balance_cents, topup_url and packs.
- `403`: forbidden_scope: a write tool called with a read-only key.
- `404`: not_found
- `429`: rate_limited
- `502`: provider_error

---

[API](https://skmtc.dev/noerrands/apis/no-errands-sign-api.md) · [All operations](https://skmtc.dev/noerrands/apis/no-errands-sign-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noerrands/apis/no-errands-sign-api/revisions/df9080c22e41?raw)
