Skip to main content
POST
/
v1
/
orders
Create orders
curl --request POST \
  --url https://api.quickbutik.com/v1/orders \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
[
  [
    {
      "order_id": "create",
      "customer": {
        "type": "consumer",
        "email": "customer@example.com",
        "phone": "+46701234567",
        "login_create": false,
        "newsletter_subscribe": true,
        "note": "Leave at the front door",
        "billing_details": {
          "firstname": "Kalle",
          "lastname": "Ankasson",
          "address": "Gladagatan 10",
          "address2": "",
          "city": "Ankeborg",
          "zipcode": "12345",
          "country": "SE"
        },
        "shipping_details": {
          "firstname": "Kalle",
          "lastname": "Ankasson",
          "address": "Gladagatan 10",
          "address2": "",
          "city": "Ankeborg",
          "zipcode": "12345",
          "country": "SE",
          "company_name": ""
        }
      },
      "payment": {
        "method": "MySaleChannel",
        "transaction_id": "TX-2024-0001",
        "currency": "SEK",
        "log": "Paid via external sales channel"
      },
      "shipping": {
        "id": 1,
        "name": "Postnord Parcel",
        "price": 49
      },
      "products": [
        {
          "product_id": 12345,
          "variant_id": 67890,
          "sku": "SHIRT-123",
          "qty": 2,
          "price": 199
        }
      ],
      "discount_add": {
        "amount": 50
      },
      "metadata": {
        "external_ref": "ERP-55213"
      }
    }
  ]
]
'
{
  "results": {}
}

Authorizations

​
Authorization
string
header
required

Basic Authentication with API Keys

The Quickbutik API uses Basic Authentication where you use your API key as both the username and password.

How it works:

  1. Format your credentials as api_key:api_key (using the SAME API key for both username and password)
  2. Base64 encode the formatted string
  3. Include in the Authorization header as: Authorization: Basic ENCODED_STRING

Example:

  • API Key: sk_live_abc123
  • Formatted: sk_live_abc123:sk_live_abc123
  • Base64 Encoded: c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=
  • Header: Authorization: Basic c2tfbGl2ZV9hYmMxMjM6c2tfbGl2ZV9hYmMxMjM=

cURL Example:

curl https://api.quickbutik.com/v1/orders -u your_api_key:your_api_key

All API requests must be made over HTTPS. Requests made over HTTP will be rejected.

API keys can be generated in the Quickbutik Control Panel under Settings → API.

Body

application/json
​
order_id
string
required

Must be the value create to create a new order.

Example:

"create"

​
customer
object
required

Customer details for the new order.

​
payment
object
required

Payment information for the new order.

​
products
object[]
required

Products to add to the order. Required when creating an order.

​
shipping
object

Shipping method for the new order.

​
discount_add
object

Optional. Set only if you would like to add a discount for this order

​
metadata
object

Custom metadata for the order

Response

Order created successfully

​
results
object

Results object containing response for each order creation attempt. Keys are dynamically generated as create_1, create_2, etc.