bill_create

Creates a bill for a customer covering a date range and starts calculating its charges. The customer must have a billing profile.

Arguments

Argument	Type	Required	Default	Description
`data`	CreateBillInput!	Yes

Return Type

CreateBillOutput

Mutation

mutation bill_create(
  $data: CreateBillInput!
) {
  bill_create(
    data: $data
  ) {
    request_id
    complexity
    bill {
      ...BillFragment
    
      id
      legacy_id
      status
      customer_name
      profile_name
      created_at
      due_date
      amount
      totals {
        ...FeeCategoryTotalConnectionFragment
      
        pageInfo {
          ...PageInfoFragment
        
          hasNextPage
          hasPreviousPage
          startCursor
          endCursor
        }
        edges {
          ...FeeCategoryTotalEdgeFragment
        
          node {
            ...FeeCategoryTotalFragment
          
            id
            legacy_id
            amount
            label
            category
            quantity
          }
          cursor
        }
      }
      bill_exports {
        ...BillExportsConnectionFragment
      
        pageInfo {
          ...PageInfoFragment
        
          hasNextPage
          hasPreviousPage
          startCursor
          endCursor
        }
        edges {
          ...BillExportsEdgeFragment
        
          node {
            ...BillExportsFragment
          
            id
            legacy_id
            status
            file_url
          }
          cursor
        }
      }
      billing_period {
        ...BillingPeriodFragment
      
        start
        end
      }
      billing_frequency
    }
  }
}

Variables

{
  "data": {
    "customer_account_id": "QWNjb3VudDoxMjM0",
    "start_date": "2026-07-09T15:30:00Z",
    "end_date": "2026-07-09T15:30:00Z",
    "warehouse_id": "V2FyZWhvdXNlOjEyMzQ="
  }
}

Response

{
  "data": {
    "bill_create": {
      "request_id": "UmVjb3JkOjEyMzQ=",
      "complexity": 100,
      "bill": {id: "QmlsbDoxMjM0"}
    }
  }
}