Creates a new loyalty card - Lobyco Help center

Creates a new loyalty card

curl --request POST \
  --url https://{host}/member/v1/loyalty-cards \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memberId": "<string>",
  "cardId": "<string>",
  "cardHolderType": "<string>",
  "operationId": "<string>"
}
'

import requests

url = "https://{host}/member/v1/loyalty-cards"

payload = {
    "memberId": "<string>",
    "cardId": "<string>",
    "cardHolderType": "<string>",
    "operationId": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    memberId: '<string>',
    cardId: '<string>',
    cardHolderType: '<string>',
    operationId: '<string>'
  })
};

fetch('https://{host}/member/v1/loyalty-cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/member/v1/loyalty-cards",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'memberId' => '<string>',
    'cardId' => '<string>',
    'cardHolderType' => '<string>',
    'operationId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{host}/member/v1/loyalty-cards"

	payload := strings.NewReader("{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/member/v1/loyalty-cards")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/member/v1/loyalty-cards")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

POST

/

v1

/

loyalty-cards

Creates a new loyalty card

curl --request POST \
  --url https://{host}/member/v1/loyalty-cards \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memberId": "<string>",
  "cardId": "<string>",
  "cardHolderType": "<string>",
  "operationId": "<string>"
}
'

import requests

url = "https://{host}/member/v1/loyalty-cards"

payload = {
    "memberId": "<string>",
    "cardId": "<string>",
    "cardHolderType": "<string>",
    "operationId": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    memberId: '<string>',
    cardId: '<string>',
    cardHolderType: '<string>',
    operationId: '<string>'
  })
};

fetch('https://{host}/member/v1/loyalty-cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/member/v1/loyalty-cards",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'memberId' => '<string>',
    'cardId' => '<string>',
    'cardHolderType' => '<string>',
    'operationId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{host}/member/v1/loyalty-cards"

	payload := strings.NewReader("{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/member/v1/loyalty-cards")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/member/v1/loyalty-cards")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"memberId\": \"<string>\",\n  \"cardId\": \"<string>\",\n  \"cardHolderType\": \"<string>\",\n  \"operationId\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Query Parameters

replaceActive

boolean

default:false

If set to true, inactivates the member's active cards when creating a new one. Otherwise, the endpoint can return an error if the maximum number of active cards limit is reached.

Body

Loyalty card creation request

memberId

string

required

Member ID

Required string length: 1 - 36

type

enum<string>

required

Available options:

Physical,

Virtual

cardId

string | null

Loyalty card ID

Maximum string length: 36

cardHolderType

string | null

Type of cardholder (e.g., Member, Employee)

Maximum string length: 32

operationId

string | null

Optional idempotency key to prevent duplicate card creation during retries or concurrent requests

Maximum string length: 128

Response

OK

Last modified on August 10, 2026

⌘I