API explorerChangelog
API explorer
Changelog

Theme switcher

Create Invoice

Create a new invoice in COUNT with full product, customer, and tag details.

UUIDs Only: All identification uses UUIDs. Integer IDs are not exposed to partner integrations.

  • Email Uniqueness: Customer emails must be unique within a team. Always use the Find by Email endpoint before attempting a POST.
  • Address Management: Both billing and shipping addresses support full field sets (Street, City, State, Zip, Country).
  • Service vs Product: Both physical goods and labor services are managed via the same underlying logic; ensure you categorize them correctly in your local system.
  • Product Categories: For customers intended to be billed, ensure they are linked to products that have a category account assigned in COUNT, or invoice creation will fail.

    • Header Parameters

    x-client-idstring
    x-signaturestring
    Authorizationstring

    Body Parameters

    customerUuidstring Required
    invoiceNumberstring Required
    datestring Required
    dueDatestring Required
    isDraftboolean Required
    invoiceTypestring Required
    Enum values:
    invoicequoteestimate
    notesstring
    productsarray Required

    Show child attributes

    tagUuidsarray

    Show child attributes

    Response

    200
    Object
    { "products": [ { "productUuid": "75dd724b-c01d-4e75-91db-86675cd7f563", "description": "Junk removal from residential property", "quantity": 1, "price": 250.00, "taxes": [] } ] }

    Response Attributes

    statusstring
    messagestring
    dataobject

    Show child attributes

    400
    Object
    Bad Request

    Response Attributes

    statusstring Required

    Always "error" for error responses

    messagestring Required

    Human-readable error description

    codestring Required

    Machine-readable error code for programmatic handling

    detailsobject

    Additional context about the error (varies by error type)

    errorsarray

    Present for validation errors with multiple fields

    Show child attributes

    401
    Object
    Unauthorized - Authentication failed

    Response Attributes

    statusstring Required

    Always "error" for error responses

    messagestring Required

    Human-readable error description

    codestring Required

    Machine-readable error code for programmatic handling

    detailsobject

    Additional context about the error (varies by error type)

    Show child attributes

    errorsarray

    Present for validation errors with multiple fields

    Show child attributes

    Was this section helpful?

    What made this section unhelpful for you?

    POST

    /

    Select
    1

    Response

    Was this section helpful?

    What made this section unhelpful for you?