Skip to main content
POST
/
v2
/
invoicing
/
invoices
/
{invoice_id}
/
send
Send invoice
curl --request POST \
  --url https://api-m.sandbox.paypal.com/v2/invoicing/invoices/{invoice_id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "subject": "<string>",
  "note": "<string>",
  "send_to_invoicer": false,
  "send_to_recipient": true,
  "additional_recipients": [
    "<string>"
  ]
}'
{
  "href": "<string>",
  "rel": "<string>",
  "method": "GET"
}

Authorizations

​
Authorization
string
header
required

Oauth 2.0 authentication

Path Parameters

​
invoice_id
string
required

The ID of the draft invoice to delete.

Maximum length: 2147483647

Body

application/json

The email or SMS notification to send to the payer when they send an invoice..

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>

Maximum length: 4000
​
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>

Maximum length: 4000
​
send_to_invoicer
boolean
default:false

Indicates whether to send a copy of the email to the merchant.

​
send_to_recipient
boolean
default:true

Indicates whether to send a copy of the email to the recipient.

​
additional_recipients
string<ppaas_common_email_address_v2>[]

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>

Maximum length: 100

The internationalized email address.<blockquote><strong>Note:</strong> Up to 64 characters are allowed before and 255 characters are allowed after the <code>@</code> sign. However, the generally accepted maximum length for an email address is 254 characters. The pattern verifies that an unquoted <code>@</code> sign exists.</blockquote>

Response

A successful request returns the HTTP 200 OK when the invoice issue date is current date.

The request-related HATEOAS link information.

​
href
string
required

The complete target URL. To make the related call, combine the method with this URI Template-formatted link. For pre-processing, include the $, (, and ) characters. The href is the key HATEOAS component that links a completed call with a subsequent call.

​
rel
string
required

The link relation type, which serves as an ID for a link that unambiguously describes the semantics of the link. See Link Relations.

​
method
enum<string>

The HTTP method required to make the related call.

Available options:
GET,
POST,
PUT,
DELETE,
HEAD,
CONNECT,
OPTIONS,
PATCH