Update invoice

PUThttps://services.leadconnectorhq.com/invoices/{invoiceId}
API to update invoice by invoice id
Request

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123

Use the Access Token generated with user type as Agency (OR) Private Integration Token of Agency.

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123
Path Parameters
invoiceId
string
required

Invoice Id

Examples:
6578278e879ad2646715ba9c
Body
altId
string
required

location Id / company Id based on altType

Example:
6578278e879ad2646715ba9c
altType
string
required

Alt Type

Allowed value:
location
Example:
location
name
string
required

Name to be updated

Example:
New Invoice
title
string

Title for the invoice

Example:
INVOICE
currency
string
required

Currency

Example:
USD
description
string

Description

Example:
ABC Corp payments
businessDetails
object

Business details which need to be updated

Example:
{"name":"Alex","address":{"addressLine1":"9931 Beechwood","city":"St. Houston","state":"TX","countryCode":"USA","postalCode":"559-6993"},"phoneNo":"+1-214-559-6993","website":"www.example.com"}
logoUrl
string

Business Logo URL

Example:
https://example.com/logo.png
name
string

Business Name

Example:
ABC Corp.
phoneNo
string

Business Phone Number

Example:
+1-214-559-6993
address
object

Business Address

Example:
9931 Beechwood, TX
website
string

Business Website Link

Example:
wwww.example.com
customValues
array[string]

Custom Values

invoiceNumber
string

Invoice Number

Example:
1001
contactId
string

Id of the contact which you need to send the invoice

Example:
6578278e879ad2646715ba9c
contactDetails
object
id
string
required

Contact ID

Example:
6578278e879ad2646715ba9c
name
string
required

Contact Name

Example:
Alex
phoneNo
string

Contact Phone Number

Example:
+1234567890
email
string

Contact Email

Example:
alex@example.com
additionalEmails
array[object]

Secondary email addresses for the contact to be saved

email
string
required
Example:
alex@example.com
companyName
string

Contact Company Name

Example:
ABC Corp.
address
object
addressLine1
string

Address Line 1

Example:
9931 Beechwood
addressLine2
string

Address Line 2

Example:
Beechwood
city
string

City

Example:
St. Houston
state
string

State

Example:
TX
countryCode
string

Country Code

Example:
US
postalCode
string

Postal Code

Example:
559-6993
customFields
array[string]

Custom Values

termsNotes
string

Terms notes, Also supports HTML markups

Example:
<p>This is a default terms.</p>
discount
object
value
number

Discount Value

Default:
0
Example:
10
type
string
required

Discount type

Allowed values:
percentagefixed
Default:
percentage
Example:
percentage
validOnProductIds
array[string]

Product Ids on which discount is applicable

Example:
[ '6579751d56f60276e5bd4154' ]
invoiceItems
array[object]
required
name
string
required

Invoice Item Name

Example:
ABC Product
description
string

Invoice descriptions

Example:
ABC Corp.
productId
string

Product Id

Example:
6578278e879ad2646715ba9c
priceId
string

Price Id

Example:
6578278e879ad2646715ba9c
currency
string
required

Currency

Example:
USD
amount
number
required

Product amount

Example:
999
qty
number
required

Product Quantity

Example:
1
taxes
array[object]

Tax

_id
string
required
name
string
required
rate
number
required
calculation
string
required
Allowed value:
exclusive
description
string
taxId
string
automaticTaxCategoryId
string

Tax category id for calculating automatic tax

Example:
6578278e879ad2646715ba9c
isSetupFeeItem
boolean

Setupfee item, only created when 1st invoice of recurring schedule is generated

type
string

Price type of the item

Allowed values:
one_timerecurring
Example:
one_time
taxInclusive
boolean

true if item amount is tax inclusive

Default:
false
Example:
true
automaticTaxesEnabled
boolean

Automatic taxes enabled for the Invoice

Example:
true
liveMode
boolean

Payment mode

issueDate
string
required

Issue date in YYYY-MM-DD format

Example:
2023-01-01
dueDate
string
required

Due date in YYYY-MM-DD format

Example:
2023-01-14
paymentSchedule
object

split invoice into payment schedule summing up to full invoice amount

type
string
required

Payment schedule type

Allowed values:
fixedpercentage
Example:
percentage
schedules
array[string]
required

payment schedule item

tipsConfiguration
object

tips configuration for the invoice

tipsPercentage
array[string]
required

Percentage of tips allowed

Example:
[5,10,15]
tipsEnabled
boolean
required

Tips enabled status

Example:
true
xeroDetails
object
invoiceNumberPrefix
string

prefix for invoice number

Example:
INV-
paymentMethods
object

Payment Methods for Invoices

stripe
object
required

Payment Method

enableBankDebitOnly
boolean
required

Enable Bank Debit Only

Example:
false
attachments
array[object]

attachments for the invoice

id
string
required

Id of the file selected

Example:
6241712be68f7a98102ba272
name
string
required

Name of the file

Example:
Electronics.pdf
url
string
required

URL of the file

Example:
https://example.com/digital-delivery
type
string
required

Type of the file

size
number
required

Size of the file

Example:
10000
Headers
Authorization
string
required

Access Token

Example:
Bearer 9c48df2694a849b6089f9d0d3513efe
Version
string
required

API Version

Allowed value:
2021-07-28

Responses

Successful response

Body

_id
string
required

Invoice Id

Example:
6578278e879ad2646715ba9c
status
string
required

Invoice Status

Allowed values:
draftsentpayment_processingpaidvoidpartially_paid
Example:
draft
liveMode
boolean
required

Live Mode

Example:
false
amountPaid
number
required

Amount Paid

Example:
0
altId
string
required

Location Id or Agency Id

Example:
6578278e879ad2646715ba9c
altType
string
required
Allowed value:
location
name
string
required

Name of the invoice

Example:
New Invoice
businessDetails
object
required

Business Details

Example:
{"name":"Alex","address":{"addressLine1":"9931 Beechwood","city":"St. Houston","state":"TX","countryCode":"USA","postalCode":"559-6993"},"phoneNo":"+1-214-559-6993","website":"www.example.com"}
invoiceNumber
number
required

Invoice Number

Example:
19
currency
string
required

Currency

Example:
USD
contactDetails
object
required

Contact Details

Example:
{"id":"c6tZZU0rJBf30ZXx9Gli","phoneNo":"+1-214-559-6993","email":"alex@example.com","customFields":[],"name":"Alex","address":{"countryCode":"US"}}
issueDate
string
required

Issue date in YYYY-MM-DD format

Example:
2023-01-01
dueDate
string
required

Due date in YYYY-MM-DD format

Example:
2023-01-01
discount
object

Discount

Example:
{"type":"percentage","value":0}
invoiceItems
array[string]
required

Invoice Items

Example:
[{"taxes":[],"_id":"c6tZZU0rJBf30ZXx9Gli","productId":"c6tZZU0rJBf30ZXx9Gli","priceId":"c6tZZU0rJBf30ZXx9Gli","currency":"USD","name":"Macbook Pro","qty":1,"amount":999}]
total
number
required

Total Amount

Example:
999
title
string
required

Title

Example:
INVOICE
amountDue
number
required

Total Amount Due

Example:
999
createdAt
string
required

created at

Example:
2023-12-12T09:27:42.355Z
updatedAt
string
required

updated at

Example:
2023-12-12T09:27:42.355Z
automaticTaxesEnabled
boolean

Automatic taxes enabled for the Invoice

Example:
true
automaticTaxesCalculated
boolean

Is Automatic taxes calculated for the Invoice items

Example:
true
paymentSchedule
object

split invoice into payment schedule summing up to full invoice amount

Unprocessable Entity

Body

statusCode
number
Example:
422
message
array[string]
Example:
["Unprocessable Entity"]
error
string
Example:
Unprocessable Entity

Unauthorized

Body

statusCode
number
Example:
401
message
string
Example:
Invalid token: access token is invalid
error
string
Example:
Unauthorized

Bad Request

Body

statusCode
number
Example:
400
message
string
Example:
Bad Request