Members API

Manage organization members — list current members, invite new ones, and remove existing members.

List members

GET /api/v1/organizations/:id/members

curl https://app.hooklistener.com/api/v1/organizations/org_abc123/members \
  -H "Authorization: Bearer hklst_your_api_key"

Response:

{
  "data": [
    {
      "id": "mem_abc123",
      "email": "[email protected]",
      "name": "Alice",
      "role": "owner",
      "joined_at": "2025-01-01T00:00:00Z"
    },
    {
      "id": "mem_def456",
      "email": "[email protected]",
      "name": "Bob",
      "role": "member",
      "joined_at": "2025-01-10T12:00:00Z"
    }
  ]
}

Invite a member

POST /api/v1/organizations/:id/members/invite

curl -X POST https://app.hooklistener.com/api/v1/organizations/org_abc123/members/invite \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

Request body:

Field	Type	Required	Description
email	string	Yes	Email address to invite

The invited user receives an email with a link to accept the invitation and join the organization.

Remove a member

DELETE /api/v1/organizations/:id/members/:member_id

curl -X DELETE https://app.hooklistener.com/api/v1/organizations/org_abc123/members/mem_def456 \
  -H "Authorization: Bearer hklst_your_api_key"

The removed member immediately loses access to all organization resources.

Roles

Role	Permissions
Owner	Full access, can manage billing, members, and all settings. Cannot be removed.
Admin	Can manage members, API keys, and organization settings. Cannot manage billing.
Member	Can view and create resources (endpoints, monitors). Cannot manage members or billing.