Create an invoice

POST 
/api/invoices

Required permissions:

• invoices.create: required to create invoices for projects where the user is PM or Account.
• invoices.create_other: required to create invoices for projects where the user is not PM or Account.

Request

Header Parameters

Wethod-Company stringrequired

The company you want to interact with

Wethod-Version stringrequired

The API version you want to use

application/json

Body

invoice_number stringnullable

Possible values: <= 255 characters

The invoice number

purchase_order stringnullable

The invoice purchase order reference

value floatrequired

The invoice value

exchange_rate floatnullable

The invoice custom exchange rate

issue_date YYYY-MM-DDrequired

The invoice issue date

notes stringnullable

The invoice notes

project_id integer

The ID of the project to associate with this invoice

budget_area_uid stringnullable

The UID of the budget area to associate with this invoice

vat_rate_id integernullable

The ID of the VAT rate to associate with this invoice

payment_term_id integernullable

The ID of the payment term to associate with this invoice

Responses

201

Returns the invoice created.

application/json

Schema

Schema

id integerrequired

Possible values: >= 1

The unique identifier of the resource

created_at date-timerequired

The date and time when the resource was created

updated_at date-timerequired

The date and time when the resource was last updated

status stringrequired

Possible values: [draft, sent, paid]

The invoice status

invoice_number stringnullable

The invoice number

purchase_order stringnullable

The invoice purchase order reference

value floatrequired

The invoice value

exchange_rate floatnullable

The invoice custom exchange rate

issue_date YYYY-MM-DDrequired

The invoice issue date

payment_date YYYY-MM-DDnullable

The invoice payment date

notes stringnullable

The invoice notes

project_id integerrequired

Possible values: >= 1

The ID of the project associated with this invoice

budget_area_uid stringnullable

The UID of the budget area associated with this invoice

vat_rate_id integernullable

The ID of the VAT rate associated with this invoice

payment_term_id integernullable

The ID of the payment term associated with this invoice

Example (from schema)

{
  "id": 1,
  "created_at": "2026-03-10T18:18:59.374Z",
  "updated_at": "2026-03-10T18:18:59.374Z",
  "status": "draft",
  "invoice_number": "INV-2024-001",
  "purchase_order": "string",
  "value": 1000,
  "exchange_rate": 0,
  "issue_date": "2024-06-15",
  "notes": "string",
  "project_id": 1,
  "budget_area_uid": "string",
  "vat_rate_id": 0,
  "payment_term_id": 0
}

400

Validation failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

failures

object[]

List of validation errors

Array [

field string

Name of the field causing the error

message string

Human-readable description of the error

]

Example (from schema)

{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

403

Forbidden

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

412

Precondition failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "precondition_failure",
  "message": "string"
}

Loading...