Send invoice

POSThttps://services.leadconnectorhq.com/invoices/{invoiceId}/send
API to send 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
userId
string
required

Please ensure that the UserId corresponds to an authorized personnel, either by an employee ID or agency ID, to access this location. This account will serve as the primary channel for all future communications and updates.

Example:
6578278e879ad2646715ba9c
action
string
required
Allowed values:
sms_and_emailsend_manuallyemailsms
liveMode
boolean
required
sentFrom
object

sender details for invoice, valid only if invoice is not sent manually

fromName
string

Sender name to be used while sending invoice

Example:
Alex
fromEmail
string

Email id to be used while sending out invoices

Example:
alex@example.com
autoPayment
object

auto-payment configuration

enable
boolean
required
type
string
paymentMethodId
string
customerId
string
card
object
brand
string
required
last4
string
required
usBankAccount
object
bank_name
string
required
last4
string
required
sepaDirectDebit
object
bank_code
string
required
last4
string
required
branch_code
string
required
bacsDirectDebit
object
sort_code
string
required
last4
string
required
becsDirectDebit
object
bsb_number
string
required
last4
string
required
cardId
string
Headers
Authorization
string
required

Access Token

Example:
Bearer 9c48df2694a849b6089f9d0d3513efe
Version
string
required

API Version

Allowed value:
2021-07-28

Responses

Successful response

Body

invoice
object
required
_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

smsData
object
required
emailData
object
required

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