Skip to content

Update standard API module settings

POST
/api/v5/bookings/v4/set_api_settings

Saves the standard API module settings for the key (titles, default dimensions, sync flags, enabled couriers, pickup warehouse). When “authtype” is “Email and Password” a new API key is created and returned; otherwise the response is true. Requires an API key.

object
authtype

Authentication type for the integration.

string
nullable
requesting_site

Domain of the site making requests with this key.

string
nullable
trans_title

Label shown to buyers for the shipping method.

string
nullable
address_type

Default sender address type, “business” or “residential”.

string
nullable
height

Default parcel height in cm.

string
nullable
width

Default parcel width in cm.

string
nullable
length

Default parcel length in cm.

string
nullable
weight

Default parcel weight in kg.

string
nullable
enable_order

Whether order syncing is enabled.

string
nullable
order_date

Earliest order date (YYYY-MM-DD) to import when syncing.

string
nullable
quotes

How many quotes to display, or the quote-display mode.

string
nullable
surcharge_price

Flat surcharge added to quoted prices, in AUD.

string
nullable
unit

Measurement unit system, e.g. metric.

string
nullable
enabled_group_box

Whether the grouped-box packing option is enabled.

string
nullable
box_size

Default box size preset used for grouped packing.

string
nullable
postcode

Pickup postcodes (4-digit AU) configured for this key.

Array<string>
postcode_type

Per-postcode address type entries, paired with the postcode list.

Array<Array<string>>
order_status
Any of:
Array<string>
key
additional properties
Any of:
string

Settings saved, or a new API key when email/password auth creates one

Any of:
boolean

Missing or invalid API key

object
error
required

Human-readable settings error message.

string

API key not found

object
error
required

Human-readable settings error message.

string