---
title: "Cancel sent invoice"
method: POST
path: "/v2/invoicing/invoices/{invoice_id}/cancel"
tags: ["invoices"]
---

# Cancel sent invoice

`POST /v2/invoicing/invoices/{invoice_id}/cancel`

## Request

- Base URL: `https://api-m.paypal.com`
- URL: `https://api-m.paypal.com/v2/invoicing/invoices/{invoice_id}/cancel`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v1/oauth2/token` scopes: `https://uri.paypal.com/services/invoicing/invoices/readwrite`
- TypeScript: <https://skmtc.dev/paypal/apis/payments/docs/v2/invoicing/invoices/:invoice_id/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

Cancels a sent invoice, by ID, and, optionally, sends a notification about the cancellation to the payer, merchant, and CC: emails.

## Path parameters

- `invoice_id` string, required

## Request body

- Notification: The email or SMS notification to send to the invoicer or payer on sending an invoice.
  - `subject` string: The subject of the email that is sent as a notification to the recipient.<blockquote><strong>Note:</strong> User-provided values for this field will not be honored and the subject will always be defaulted to a system-defined value.</blockquote>
  - `note` string: A note to the payer.<blockquote><strong>Note:</strong> User-provided values for this field will not be honored and the note will always be defaulted to a system-defined value.</blockquote>
  - `send_to_invoicer` boolean: Indicates whether to send a copy of the email to the merchant.
  - `send_to_recipient` boolean: Indicates whether to send a copy of the email to the recipient.
  - `additional_recipients` EmailAddress[]: An array of one or more CC: emails to which notifications are sent. If you omit this parameter, a notification is sent to all CC: email addresses that are part of the invoice.<blockquote><strong>Note:</strong> Valid values are email addresses in the `additional_recipients` value associated with the invoice.</blockquote>

## Response `204`

A successful request returns the HTTP `204 No Content` status code with no JSON response body.

## Other responses

- `400`: Invalid request.
- `403`: Authorization Error.
- `404`: Resource Not Found.
- `422`: Unprocessable Entity.
- `500`: An internal server error has occurred.
- `default`: The default response.

---

[API](https://skmtc.dev/paypal/apis/payments.md) - [All operations](https://skmtc.dev/paypal/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/paypal/apis/payments/revisions/672aceee1190?raw)