Skip to main content
curl --request POST 'https://api.mayar.id/hl/v2/memberships/members/create' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
    "customerInfo": {
        "name": "Budi Santoso",
        "email": "budi.santoso@example.com",
        "mobile": "081234567890"
    },
    "membershipMonthlyPeriod": 1
}'

{
    "statusCode": 201,
    "message": "success",
    "data": {
        "membershipCustomer": {
            "id": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
            "memberId": "MBR8X2QK",
            "userId": "348e083d-315a-4e5c-96b1-5a2a98c48413",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
            "paymentLinkId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
            "monthlyPaymentPeriod": 1,
            "status": "active",
            "nextPayment": "2026-07-20T09:10:57.994Z",
            "expiredAt": null,
            "createdAt": "2026-06-20T09:10:57.994Z",
            "updatedAt": "2026-06-20T09:10:57.994Z"
        }
    }
}
Endpoint: 
https://api.mayar.id/hl/v2/memberships/members/create

​
Authorization

​
Authorization
string
required
Example:Authorization | Bearer Paste-Your-API-Key-Here

​
Request Body

​
productId
string
required
The unique identifier of the product (payment link) the new member is registered against. The product must belong to the authenticated user.Example:7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f
​
membershipTierId
string
required
The unique identifier of the membership tier the member is enrolled in.Example:9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d
​
customerInfo
object
required
The customer’s contact details.
​
customerInfo.name
string
required
The customer’s full name.
​
customerInfo.email
string
required
The customer’s email address. A customer may only be registered once per tier — re-using an email that already exists on the same tier responds 400 "Email sudah terdaftar pada tier ini.".
​
customerInfo.mobile
string
required
The customer’s mobile phone number.
​
membershipMonthlyPeriod
integer
required
The monthly billing period for the membership (for example 1).

​
Response

Successful Response — HTTP 201

​
Main Structure (Root Object)

​
statusCode
integer
Status code from the API. 201 on successful registration.
​
message
string
Status message that describes the status code. Note the singular message key (write endpoints use message; read/list endpoints use the plural messages).
​
data
object
The registration result wrapper.
​
data.membershipCustomer
object
The newly created membership customer record.

​
Errors

All errors use the envelope { "statusCode": <code>, "message": "<reason>" } (singular message).
Error Example 400
{
    "statusCode": 400,
    "message": "Email sudah terdaftar pada tier ini."
}
​
statusCode
integer
The HTTP status code of the error.
​
message
string
A human-readable description of the error.
Common errors:
StatusmessageWhen
400Validation ErrorThe request body fails validation (missing or malformed fields).
400You are not authorized to edit this product!The productId does not belong to the authenticated user.
400Email sudah terdaftar pada tier ini.A customer with this email is already registered on the given tier.
400Paket membership ini telah mencapai batas limit anggota yang ditentukan.The tier has reached its configured member limit.