Create a price list

POST 
/api/price-lists

• pricelist.edit: allows to create resources of price lists.

Here the dedicated support page.

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

client_id integer

ID of the client to associate with this price list

name stringrequired

Possible values: <= 255 characters

The price list name

description string

Possible values: <= 50 characters

The price list description

available_from date

The date from which the price list is available. This follows the YYYY-MM-DD format

available_to date

The date until which the price list is available. This follows the YYYY-MM-DD format

is_default_for_client boolean

Whether this price list is the default for the client

sync_with_company_default boolean

Whether this price list is synced with the company default costs

Responses

201

Returns the price list 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

name stringrequired

The price list name

description string

The price list description

available_from date

The date from which the price list is available. This follows the YYYY-MM-DD format

available_to date

The date until which the price list is available. This follows the YYYY-MM-DD format

is_default_for_client booleanrequired

Whether this is the default price list for the client

is_default_for_company booleanrequired

Whether this is the default price list for the company

uses_default_price_list_costs booleanrequired

Whether to sync costs with company default price list

client_id integer

Possible values: >= 1

ID of the client to associate with this employee

Example (from schema)

{
  "id": 1,
  "created_at": "2025-09-18T11:10:23.731Z",
  "updated_at": "2025-09-18T11:10:23.731Z",
  "name": "string",
  "description": "string",
  "available_from": "2025-09-18",
  "available_to": "2025-09-18",
  "is_default_for_client": true,
  "is_default_for_company": true,
  "uses_default_price_list_costs": true,
  "client_id": 1
}

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"
}

Loading...