API Documentation
API Endpoints/Products

Create productgroups

POST
/productgroups
AuthorizationBasic <token>

Basic authentication is a simple authentication scheme built into the HTTP protocol. To use it, send your HTTP requests with an Authorization header that contains the word Basic followed by a space and a base64-encoded string username:password.Example: Authorization: Basic ZGVtbzpwQDU1dzByZA==

In: header

Header Parameters

Idempotency-Key?string

Set this optional header to the same value for idempotent requests. If the request is repeated with the same idempotency key, the server will return the same response as for the first request. Our servers retain the idempotency key and their result for 24 hours after the initial request, if not defined otherwise in your Abillify contract.

reference?string

Your unique id for the element, ie. the id of the element in your database

meta?object

Merchant data related to the entity

Empty Object

active?boolean
Defaulttrue
description_long_localized?object

Long descritpion of productgroup, localized, allows html/markdown, shown on checkout

Default"{}"

Empty Object

description_short_localized?object

Description of productgroup, localized, plain text, shown on checkout and invoice

Default"{}"

Empty Object

label?string

Label of product group, internal use

parent?string

Parent product group

Match^-?[0-9]+$
title_localized?object

Title of productgroup, localized, plain text, show on checkout and invoice, if not defined label is used

Default"{}"

Empty Object

Response Body

curl -X POST "https://staging1.abillify.dev/api/productgroups" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  -d '{}'
const body = JSON.stringify({})

fetch("https://staging1.abillify.dev/api/productgroups", {
  headers: {
    "Idempotency-Key": "string"
  },
  body
})
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
  "strings"
)

func main() {
  url := "https://staging1.abillify.dev/api/productgroups"
  body := strings.NewReader(`{}`)
  req, _ := http.NewRequest("POST", url, body)
  req.Header.Add("Idempotency-Key", "string")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://staging1.abillify.dev/api/productgroups"
body = {}
response = requests.request("POST", url, json = body, headers = {
  "Idempotency-Key": "string",
  "Content-Type": "application/json"
})

print(response.text)
{
  "client": "123456789",
  "committed": "2022-07-29 17:23:47",
  "created": "2022-07-29 17:23:47",
  "id": "123456789",
  "modified": "2022-07-29 17:23:47",
  "reference": "abcdefg",
  "meta": {},
  "active": false,
  "description_long_localized": {
    "de": "Beschreibung auf Deutsch",
    "en": "Description in English"
  },
  "description_short_localized": {
    "de": "Beschreibung auf Deutsch",
    "en": "Description in English"
  },
  "label": "abcdefg",
  "parent": "123456789",
  "title_localized": {
    "de": "Titel auf Deutsch",
    "en": "Title in english"
  }
}
{
  "code": 400,
  "details": [
    {
      "error": "Value for field 'debtor' is of wrong type, expected bigint.",
      "fields": [
        "debtor"
      ],
      "hint": "Value must be a number or a string containing only a number."
    }
  ],
  "message": "InvalidValue, see error details",
  "name": "ClientError",
  "type": "ERR_INVALID_VALUE"
}
{
  "code": 400,
  "details": [
    {
      "error": "Value for field 'debtor' is of wrong type, expected bigint.",
      "fields": [
        "debtor"
      ],
      "hint": "Value must be a number or a string containing only a number."
    }
  ],
  "message": "InvalidValue, see error details",
  "name": "ClientError",
  "type": "ERR_INVALID_VALUE"
}