Create Location

​
Headers
  • Accept
    enum
    const:  
    application/json
    required

    Response format. Must be application/json.

    values
    • application/json
  • Content-Type
    enum
    const:  
    application/json
    required

    Request payload format. Must be application/json when a body is sent.

    values
    • application/json
Body·LocationCreate
required
application/json
  • account_id
    Type: string · Account Id
    required
  • name
    Type: string · Name
    required
  • address
    Type: object · Address nullable
  • country_code
    Type: string | null · Country Code
  • currency
    Type: string | null · Currency
  • email
    Type: string | null · Email
  • metadata
    Type: object | null · Metadata
  • phone
    Type: string | null · Phone
  • processor_config_id
    Type: string | null · Processor Config Id
  • status
    Type: string · Status
  • surcharge_rate
    Type: number | null · Surcharge Rate

    Surcharge percentage (e.g., 3.5 for 3.5%). Setting to null disables automatic surcharge logic. Setting to 0 means surcharges will NEVER be applied unless explicitly overridden.

  • terminal_id
    Type: string | null · Terminal Id
Responses
  • application/json
  • application/json
Request Example for post/v1/locations
curl https://api.uat.koard.com/v1/locations \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'x-koard-apikey: YOUR_SECRET_TOKEN' \
  --data '{
  "account_id": "",
  "address": {
    "city": "",
    "state": "",
    "street_line1": "",
    "street_line2": "",
    "zip": ""
  },
  "country_code": "840",
  "currency": "USD",
  "email": null,
  "metadata": null,
  "name": "",
  "phone": null,
  "processor_config_id": null,
  "status": "active",
  "surcharge_rate": null,
  "terminal_id": null
}'

{
  "account_id": "string",
  "address": {
    "city": "string",
    "state": "string",
    "street_line1": "string",
    "street_line2": "",
    "zip": "string"
  },
  "country_code": null,
  "created_at": null,
  "currency": null,
  "deleted_at": null,
  "email": null,
  "id": "string",
  "metadata": null,
  "name": "string",
  "phone": null,
  "processor_config_id": null,
  "status": "active",
  "surcharge_rate": null,
  "terminal_id": null,
  "updated_at": null
}

Successful Response