---
title: "Email a change order to the customer"
method: POST
path: "/change-orders/{id}/send"
tags: ["ChangeOrders"]
---

# Email a change order to the customer

`POST /change-orders/{id}/send`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/change-orders/{id}/send`
- Auth: HTTP bearer

Emails the change order PDF to the given recipients and marks it sent. Same delivery pipeline as the product's send action. Requires change_orders:send. Set requestSignature to true to include a signing link in that same email. That also requires the signatures:send scope, a signer name, and e-signature to be enabled for the organization. The signer email defaults to the project contact, then the first To address. Approved, rejected, and voided change orders cannot be sent for signature; a plain email of those change orders is still allowed. The response includes signatureRequested and, when a request was created, signatureRequestId. It never includes a signing URL or recipient token.

## Path parameters

- `id` integer, required

## Headers

- `Idempotency-Key` string, uuid

## Request body

- object
  - `templateId` integer
  - `recipientEmails` string[], required
  - `cc` string[]
  - `bcc` string[]
  - `subject` string
  - `body` string
  - `requestSignature` boolean: When true, this send also starts an e-signature and the email includes the signing link. Defaults to false. Also requires the signatures:send scope and a signer name.
  - `signerEmail` string, email: Signer email. Defaults to the project contact's email, then the first To address. Must be one of the recipients.
  - `signerName` string: Signer name. Required when requestSignature is true.

## Response `200`

Sent

- object
  - `data` object, required
    - `success` boolean, required
    - `messageId` string, nullable, required
    - `recipientCount` integer, required
    - `changeOrderId` integer, required
    - `signatureRequested` boolean, required: True when this send created an e-signature request.
    - `signatureRequestId` integer: Id of the signature request created by this send. Never a signing URL or recipient token.
  - `meta` ResponseMeta, required
    - `request_id` string: Server-generated request identifier
    - `pagination` PaginationMeta
      - `cursor` string, nullable, required: Opaque cursor for the next page; null when no more results
      - `has_more` boolean, required: Whether more pages are available after this one
      - `count` integer, required: Items in this page

## Other responses

- `400`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `503`: Error

---

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