Skip to main content
POST
/
invoice_groups
Create an invoice group
curl --request POST \
  --url https://api.togai.com/invoice_groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dailyInvoiceConsolidation": true,
  "accountIds": [
    "ACC0001",
    "ACC0002"
  ],
  "netTermDays": 30
}
'
{
  "id": "inv_group.20rvWRxQcQK.0ZwPG",
  "name": "Invoice Group 1",
  "email": "[email protected]",
  "dailyInvoiceConsolidation": true,
  "accountsCount": 2,
  "gracePeriod": 3,
  "netTermDays": 45,
  "invoiceCurrency": "USD",
  "billingAddress": {
    "phoneNumber": "+919876543210",
    "line1": "2281 Broadway Street",
    "line2": "G-31",
    "postalCode": "29501",
    "city": "Florence",
    "state": "South Carolina",
    "country": "US"
  },
  "createdAt": "2023-07-26T12:36:56.58015Z",
  "updatedAt": "2023-07-26T12:36:56.58015Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload to approve or decline a proposal

Create an invoice group

​
name
string
required
​
email
string
required
Maximum string length: 320
​
dailyInvoiceConsolidation
boolean
required
​
accountIds
string[]
required
Required array length: 1 - 100 elements
​
address
object
required

billing address of the customer

​
netTermDays
integer<int32>

Response

Response to create invoice group request

Invoice group details

​
id
string
required
​
name
string
required
​
email
string
required
Maximum string length: 320
​
dailyInvoiceConsolidation
boolean
required
​
invoiceCurrency
string
required
​
billingAddress
object
required

billing address of the customer

​
accountsCount
integer<int32>
required
Required range: x >= 0
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
netTermDays
integer<int32>