Skip to main content

Bulk Create Members

Bulk-create multiple loyalty members in a single request.

When to Use

Use this endpoint when:

  • Importing customers from a CRM or CSV
  • Onboarding many members at once

How to Use

Endpoint
POST/v3/loyalty/members

POST an array of member objects to /v3/loyalty/members.


Request Parameters

membersARRAYrequired

Array of member objects to create

nameSTRINGrequired

Member name

Example: "testing 1"

countryCodeSTRINGrequired

Country code of member contact number

Example: "60"

phoneNumberSTRINGrequired

Phone number of member

Example: "1622288812"

nricSTRINGrequired

IC Number

Example: "970503145887"

emailSTRINGrequired

Email address of member

Example: "[email protected]"

genderSTRINGrequired

Gender

Example: "MALE"

stateSTRING

Member state

Example: ""

addressOBJECT

Refer to explanation below

addressLine1STRING

Address 1

Example: ""

addressLine2STRING

Address 2

Example: ""

postcodeSTRING

Postcode

Example: "52100"

citySTRING

City

Example: ""

countrySTRING

Country

Example: ""

loyaltyPointINTEGERrequired

Loyalty Point

Example: 10

Response Parameters

itemARRAY

Array of member creation results

nameSTRING

Member name

Example: "testing 1"

countryCodeSTRING

Country code of member contact number

Example: "60"

phoneNumberSTRING

Phone number of member

Example: "1622288812"

emailSTRING

Email address of member

Example: "[email protected]"

nricSTRING

IC Number

Example: "970503145887"

birthDateSTRING

Member Birth Date

Example: "2019-01-01T00:00:00Z"

genderSTRING

Gender

Example: "MALE"

addressOBJECT

Refer to explanation below

postcodeSTRING

Postcode

Example: "52100"

loyaltyPointINTEGER

Loyalty Point

Example: 10

statusSTRING

Creation status of this member (e.g. SUCCESS, FAILED)

Example: "FAILED"

errorSTRING

Error code when status is FAILED (Refer Appendix 1: Error Codes)

Example: "MEMBER_REGISTERED"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"