Members

Your artists and labels: list them and invite new ones.

Base URL https://app.hillsmusic.com/api/v1. Every request sends an API key: Authorization: Bearer hm_live_… (production) or hm_test_… (sandbox).

• List artists and labels
• Invite an artist or label

List artists and labels

GET /api/v1/members · Scope: members:read · Sandbox keys see sandbox data only.

Every artist and label under your account, newest first, with how many releases each has (in the key’s environment).

Parameters

Example request

curl "https://app.hillsmusic.com/api/v1/members?kind=artist" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Response 200

{
  "data": [
    {
      "id": 41,
      "email": "luna@example.com",
      "name": "Luna",
      "kind": "artist",
      "status": "active",
      "created_at": "2026-08-02T10:11:00Z",
      "last_login_at": null,
      "releases": 4
    }
  ]
}

Errors

Invite an artist or label

POST /api/v1/members/invite · Scope: members:write · Sandbox keys are refused (403 not_in_sandbox).

Creates the account under yours and emails them a link (valid 7 days) to set their password. 409 if the email already has an account.

Request body

JSON.

Example request

curl -X POST "https://app.hillsmusic.com/api/v1/members/invite" \
  -H "Authorization: Bearer $HILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"luna@example.com","fname":"Luna","kind":"artist"}'

Response 201

{
  "ok": true,
  "id": 57
}

Errors