---
title: "Send work order as an email"
method: POST
path: "/workorders/{id}/emails"
tags: ["Work Orders"]
---

# Send work order as an email

`POST /workorders/{id}/emails`

## Path parameters

- `id` integer, required

## Query parameters

- `skipWebhook` boolean

## Request body

- object
  - `emails` string[] — Emails to send the Work Order to
  - `customMessage` string, nullable — Custom message to send with the Work Order
  - `exportOptions` object, nullable — Type of export options for the work order attached to the email
    - `attachments` boolean, nullable — Include attachments
    - `comments` boolean, nullable — Include comments
    - `costs` 'DETAILED' | 'NONE' | 'SUMMARY', nullable — Include cost-related information
    - `history` boolean, nullable — Include work order history
    - `procedureFormat` 'DETAILED' | 'FLAGS_FAILS' | 'NONE' | 'SUMMARY', nullable — Include procedure format
    - `images` 'FULL_SIZE' | 'ORIGINAL_SIZE' | 'REGULAR_SIZE' | 'SHOW_AS_FILE' | 'THUMBNAIL_SIZE', nullable — Include images
    - `includeBasicInformation` boolean, nullable — Include basic information
    - `includeExportInformation` boolean, nullable — Include export information
    - `includeLocationAddress` boolean, nullable — Include location address
    - `includedCustomFields` string[], nullable — Include custom fields
    - `priority` boolean, nullable — Include priority information
    - `qrCode` boolean, nullable — Include QR code
    - `signatureBox` boolean, nullable — Include signature box
    - `vendorInformation` boolean, nullable — Include vendor information
    - `vendors` boolean, nullable — Include vendors
    - `workOrderInfo` boolean, nullable — Include work order information

## Response `201`

Successfully created the email

- object
  - `id` integer — Global ID of the work order

## Other responses

- `400` — Failed to create the email
- `401` — Invalid token
- `403` — You do not have permission to send this email
- `404` — Could not find the specified Work Order.

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)