Nookhive Logo
StyleguideAPI Reference

Members API

Manage organization membership data, member profiles, and membership status.

Overview

The Members API allows you to manage your organization's membership directory. This includes adding new members, updating member information, and managing membership status.

Members can be associated with individuals and organizations within NookHive, enabling features like member pricing for events.

Base Path

https://api.nookhive.com/v1/members

Endpoints

GET/v1/members

List Members

Returns a paginated list of all members in your organization.

Parameters

NameTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
statusstringFilter by status: ACTIVE, EXPIRED, PENDING
searchstringSearch by name, email, or company
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/members?status=ACTIVE" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
ResponseJSON
{
  "members": [
    {
      "id": "mem_abc123",
      "membershipNumber": "M-2026-001",
      "name": "John Doe",
      "email": "john@example.com",
      "company": "Acme Corp",
      "membershipType": "CORPORATE",
      "status": "ACTIVE",
      "expiresAt": "2026-12-31T23:59:59Z",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}
GET/v1/members/{id}

Get Member Details

Retrieve detailed information about a specific member.

Parameters

NameTypeDescription
id*stringMember ID or membership number
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/members/mem_abc123" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
POST/v1/members

Create Member

Add a new member to your organization's membership directory.

Parameters

NameTypeDescription
name*stringMember full name
email*stringMember email address
companystringCompany or organization name
membershipTypestringMembership type: INDIVIDUAL, CORPORATE, STUDENT
membershipNumberstringCustom membership number (auto-generated if not provided)
expiresAtISO 8601Membership expiration date
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/members" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "jane@techcorp.com",
    "company": "Tech Corp",
    "membershipType": "CORPORATE",
    "expiresAt": "2026-12-31T23:59:59Z"
  }'
ResponseJSON
{
  "member": {
    "id": "mem_def456",
    "membershipNumber": "M-2026-002",
    "name": "Jane Smith",
    "email": "jane@techcorp.com",
    "company": "Tech Corp",
    "membershipType": "CORPORATE",
    "status": "ACTIVE",
    "expiresAt": "2026-12-31T23:59:59Z",
    "createdAt": "2026-01-15T10:00:00Z"
  }
}
PUT/v1/members/{id}

Update Member

Update an existing member's information.

Parameters

NameTypeDescription
id*stringMember ID
namestringMember full name
emailstringMember email address
companystringCompany name
statusstringMembership status: ACTIVE, EXPIRED, SUSPENDED
expiresAtISO 8601Membership expiration date
Example RequestBASH
curl -X PUT "https://api.nookhive.com/v1/members/mem_abc123" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "expiresAt": "2027-12-31T23:59:59Z"
  }'
DELETE/v1/members/{id}

Delete Member

Remove a member from the membership directory. This is a soft delete - the member record is marked as deleted but retained for historical purposes.

Parameters

NameTypeDescription
id*stringMember ID
Example RequestBASH
curl -X DELETE "https://api.nookhive.com/v1/members/mem_abc123" \
  -H "Authorization: Bearer nk_live_your_api_key_here"

The Member Object

{
  "id": "mem_abc123",
  "membershipNumber": "M-2026-001",
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "company": "Acme Corp",
  "jobTitle": "Software Engineer",
  "membershipType": "CORPORATE",
  "status": "ACTIVE",
  "joinedAt": "2026-01-01T00:00:00Z",
  "expiresAt": "2026-12-31T23:59:59Z",
  "renewedAt": null,
  "metadata": {
    "industry": "Technology",
    "referredBy": "Partner Conference"
  },
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}