Create Member Profile API Reference

Create Profile

curl --request POST \
  --url https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "relation_reference": "jane.doe@example.com",
  "full_name": "Jane Doe",
  "email_id": "jane.doe@example.com",
  "mobile_number": "+919876543210",
  "gender": "F",
  "dob": "1990-06-15",
  "status": "5"
}
'

import requests

url = "https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes"

payload = {
    "relation_reference": "jane.doe@example.com",
    "full_name": "Jane Doe",
    "email_id": "jane.doe@example.com",
    "mobile_number": "+919876543210",
    "gender": "F",
    "dob": "1990-06-15",
    "status": "5"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    relation_reference: 'jane.doe@example.com',
    full_name: 'Jane Doe',
    email_id: 'jane.doe@example.com',
    mobile_number: '+919876543210',
    gender: 'F',
    dob: '1990-06-15',
    status: '5'
  })
};

fetch('https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes', 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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes",
  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([
    'relation_reference' => 'jane.doe@example.com',
    'full_name' => 'Jane Doe',
    'email_id' => 'jane.doe@example.com',
    'mobile_number' => '+919876543210',
    'gender' => 'F',
    'dob' => '1990-06-15',
    'status' => '5'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes"

	payload := strings.NewReader("{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}"

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

{
  "results": {
    "IsSucessful": true,
    "ErrorCode": "000",
    "ExceptionMessage": "Success",
    "ReturnObject": true
  }
}

{
  "results": {
    "IsSucessful": false,
    "ErrorCode": "E409",
    "ExceptionMessage": "Member already exists"
  }
}

POST

lbms-ingress

member

api

Member

CreateProfileWithAttributes

Create Profile

curl --request POST \
  --url https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "relation_reference": "jane.doe@example.com",
  "full_name": "Jane Doe",
  "email_id": "jane.doe@example.com",
  "mobile_number": "+919876543210",
  "gender": "F",
  "dob": "1990-06-15",
  "status": "5"
}
'

import requests

url = "https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes"

payload = {
    "relation_reference": "jane.doe@example.com",
    "full_name": "Jane Doe",
    "email_id": "jane.doe@example.com",
    "mobile_number": "+919876543210",
    "gender": "F",
    "dob": "1990-06-15",
    "status": "5"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    relation_reference: 'jane.doe@example.com',
    full_name: 'Jane Doe',
    email_id: 'jane.doe@example.com',
    mobile_number: '+919876543210',
    gender: 'F',
    dob: '1990-06-15',
    status: '5'
  })
};

fetch('https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes', 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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes",
  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([
    'relation_reference' => 'jane.doe@example.com',
    'full_name' => 'Jane Doe',
    'email_id' => 'jane.doe@example.com',
    'mobile_number' => '+919876543210',
    'gender' => 'F',
    'dob' => '1990-06-15',
    'status' => '5'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes"

	payload := strings.NewReader("{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://loyalife-api.xoxoday.in/lbms-ingress/member/api/Member/CreateProfileWithAttributes")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"relation_reference\": \"jane.doe@example.com\",\n  \"full_name\": \"Jane Doe\",\n  \"email_id\": \"jane.doe@example.com\",\n  \"mobile_number\": \"+919876543210\",\n  \"gender\": \"F\",\n  \"dob\": \"1990-06-15\",\n  \"status\": \"5\"\n}"

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

{
  "results": {
    "IsSucessful": true,
    "ErrorCode": "000",
    "ExceptionMessage": "Success",
    "ReturnObject": true
  }
}

{
  "results": {
    "IsSucessful": false,
    "ErrorCode": "E409",
    "ExceptionMessage": "Member already exists"
  }
}

Registers a new member in your loyalty program. The relation_reference you supply becomes the member’s permanent identifier across all Loyalife APIs — choose it carefully (typically an email-based UUID or your internal customer ID). New members are created in Inactive status by default; activation happens through a separate workflow. If a member with the same relation_reference already exists, the API returns a 409 rather than overwriting.

Member Status Values

Code	Status	Description
`1`	Active	Member is fully active — can earn points, redeem, and log in
`2`	Suspended	Member account is suspended
`3`	Login Blocked	Member cannot log in but other operations may still function
`4`	Canceled	Member account has been canceled
`5`	Inactive	Default state for new enrollments — member is enrolled but not yet activated
`6`	Membership Blocked	Member’s loyalty membership is blocked

Status can be managed both via API and through the Loyalife Admin portal. Any mandatory custom attributes defined in your CPD schema must also be included in the request. Optional custom attributes can also be passed.

Responses

200 — Success

Path	Type	Description
`results.IsSucessful`	boolean	`true`
`results.ErrorCode`	string	`000`
`results.ExceptionMessage`	string	`Success`
`results.ReturnObject`	boolean	`true` on successful enrollment

409 — Member Already Exists

Path	Type	Description
`results.IsSucessful`	boolean	`false`
`results.ErrorCode`	string	Error code from the platform
`results.ExceptionMessage`	string	Human-readable reason — check this field for details

Error Codes

Code	ExceptionMessage	Cause
`000`	Success	Member enrolled successfully
`E201`	Duplicate record	`relation_reference` already exists in this program
`E205`	Duplicate Email: The email already exists	`email_id` is already registered to another member
`E206`	Duplicate Mobile: The mobile number already exists	`mobile_number` is already registered to another member
`E102`	Invalid Email	`email_id` format is invalid
`E103`	Mandatory field missing — MRN	`relation_reference` not provided
`E104`	Mandatory field missing — Name	`full_name` not provided
`E105`	Mandatory field missing — Mobile Number	`mobile_number` not provided
`E106`	Mandatory field missing — DOB	`dob` not provided
`E107`	Mandatory field missing — Gender	`gender` not provided
`006`	Insert failed	Data was valid but the database insertion failed
`999`	Bad request	Malformed JSON or missing required fields

email_id is configured as non-mandatory for some programs (e.g. Citibank). Mandatory field codes E103–E107 only fire when the field is configured as required for your program.

Authorizations

Authorization

string

header

required

JWT obtained from Generate Auth Token. Pass as Authorization: bearer {token}.

Query Parameters

pintProgramId

integer

required

Your loyalty program ID

Example:

19

Body

application/json

relation_reference

string

required

Unique member identifier — typically email-based. Primary key across all APIs.

Example:

"jane.doe@example.com"

full_name

string

required

Example:

"Jane Doe"

email_id

string<email>

required

Example:

"jane.doe@example.com"

mobile_number

string

required

Example:

"+919876543210"

status

string

required

Use 5 for Inactive — standard initial state for new enrollments.

Example:

"5"

address

string

Example:

"123 Main Street, Mumbai 400001"

gender

enum<string>

Available options:

M,

F,

O

Example:

"F"

dob

string<date>

Date of birth in YYYY-MM-DD format

Example:

"1990-06-15"

Response

Member created

⌘I

Overview

Core Concepts

Authentication

Member Management

OTP

Transactions

Points Redemption

Create Profile

Member Status Values

Responses

Error Codes

Authorizations

Query Parameters

Body

Response

​Member Status Values

​Responses

​Error Codes

Authorizations

Query Parameters

Body

Response

Member Status Values

Responses

Error Codes