Status: Stable.

Members: Create or Update

Use this endpoint to create or update a member/cardholder before awarding points or requesting redemptions.

Endpoint

POST /api/v1/members

What happens

More Rewards:

1. authenticates the club key
2. validates the member payload
3. creates or updates the member for that club
4. stores wallet details when supplied
5. uses bank-account details for payout readiness checks

Request body

{
  "partnerRef": "club_public_id",
  "member": {
    "externalMemberId": "member_external_id",
    "firstName": "Example",
    "lastName": "Member",
    "email": "member@example.com",
    "wallet": {
      "provider": "moneyhub",
      "walletRef": "sandbox_wallet_member_external_id",
      "status": "verified",
      "bankAccount": {
        "accountNumber": "12345678",
        "sortCode": "123456",
        "name": "Example Member"
      }
    }
  }
}

Field notes

| Field | Required | Notes | | --- | --- | --- | | partnerRef | Yes | Public club reference supplied by More Rewards. | | member.externalMemberId | Yes | Your stable member/cardholder identifier. | | member.firstName | Yes | Member first name. | | member.lastName | Yes | Member last name. | | member.email | Yes | Member email address. | | member.wallet | Recommended | Required when the member should be payout-ready. | | member.wallet.bankAccount.accountNumber | Recommended for payouts | UK account number for payout routing. | | member.wallet.bankAccount.sortCode | Recommended for payouts | UK sort code, six digits. | | member.wallet.bankAccount.name | Recommended for payouts | Account holder name. |

Success responses

Created member:

{
  "ok": true,
  "data": {
    "externalMemberId": "member_external_id",
    "status": "created"
  }
}

Updated member:

{
  "ok": true,
  "data": {
    "externalMemberId": "member_external_id",
    "status": "updated"
  }
}

Common errors

• invalid_request
• unauthorized
• partner_not_found