How do I export all my members?

Run memberstack members export to export all members as JSON. Add --format csv for CSV output. You can specify a custom file path with --output, otherwise it defaults to members.json or members.csv in the current directory.

Can I bulk update members from a file?

Yes. Use memberstack members bulk-update --file updates.csv to update members in bulk. Each row must include the member ID. Add --dry-run to preview changes before applying them.

How do I find members by custom field values?

Use memberstack members find --field key=value to search by custom field. You can combine multiple field filters and also filter by plan ID with --plan.

What file format do I need for importing members?

Import files (CSV or JSON) require email and password fields. Optional fields include plans (comma-separated plan IDs), loginRedirect, and any custom fields or metadata using the customFields.* and metaData.* prefixes.

Members | Memberstack CLI

memberstack members <subcommand> [options]

members list

List members with optional pagination and sorting.

memberstack members list [options]

Options

Option	Description	Default
`--after <cursor>`	Pagination cursor (from previous `endCursor`)	—
`--order <order>`	Sort order: `ASC` or `DESC`	`ASC`
`--limit <number>`	Maximum members to return (max 200)	`50`
`--all`	Auto-paginate and fetch all members	—

Examples

memberstack members list
memberstack members list --limit 100 --order DESC
memberstack members list --all

Results are written to members.json in the current directory.

members get

Get a member by ID or email.

memberstack members get <id_or_email>

Arguments

Argument	Description	Required
`id_or_email`	Member ID (`mem_...`) or email address	Yes

Examples

memberstack members get mem_abc123
memberstack members get user@example.com

members create

Create a new member.

memberstack members create [options]

Options

Option	Description	Required
`--email <email>`	Member email address	Yes
`--password <password>`	Member password	Yes
`--plans <planId>`	Plan ID to connect (repeatable)	No
`--custom-fields <key=value>`	Custom field value (repeatable)	No
`--meta-data <key=value>`	Metadata field value (repeatable)	No
`--login-redirect <url>`	Login redirect URL	No

Examples

memberstack members create --email user@example.com --password secure123

memberstack members create \
  --email user@example.com \
  --password secure123 \
  --plans pln_abc123 \
  --custom-fields tier=premium \
  --meta-data ref=partner

members update

Update an existing member.

memberstack members update <id> [options]

Arguments

Argument	Description	Required
`id`	Member ID (`mem_...`)	Yes

Options

Option	Description
`--email <email>`	Update email address
`--custom-fields <key=value>`	Custom field value (repeatable)
`--meta-data <key=value>`	Metadata field value (repeatable)
`--json-data <json>`	Additional JSON data as a string
`--login-redirect <url>`	Login redirect URL

Examples

memberstack members update mem_abc123 --email newemail@example.com
memberstack members update mem_abc123 --custom-fields tier=gold

members delete

Delete a member.

memberstack members delete <id>

Arguments

Argument	Description	Required
`id`	Member ID (`mem_...`)	Yes

Examples

memberstack members delete mem_abc123

members add-plan

Add a free plan to a member.

memberstack members add-plan <id> --plan-id <planId>

Arguments

Argument	Description	Required
`id`	Member ID (`mem_...`)	Yes

Options

Option	Description	Required
`--plan-id <planId>`	Plan ID to add (`pln_...`)	Yes

Example

memberstack members add-plan mem_abc123 --plan-id pln_xyz789

members remove-plan

Remove a free plan from a member.

memberstack members remove-plan <id> --plan-id <planId>

Arguments

Argument	Description	Required
`id`	Member ID (`mem_...`)	Yes

Options

Option	Description	Required
`--plan-id <planId>`	Plan ID to remove (`pln_...`)	Yes

Example

memberstack members remove-plan mem_abc123 --plan-id pln_xyz789

members count

Show total member count.

memberstack members count

Example

$ memberstack members count
Total members: 1,234

members find

Find members by custom field values or plan.

memberstack members find [options]

Options

Option	Description
`--field <key=value>`	Filter by custom field (repeatable)
`--plan <planId>`	Filter by plan ID

Examples

memberstack members find --plan pln_abc123
memberstack members find --field tier=premium --field status=active

members stats

Show member statistics.

memberstack members stats

Description

Displays an overview of member activity including total count, active vs inactive members, recent signups, and a breakdown by plan.

Example

$ memberstack members stats
Member Statistics
  Total members:       1,234
  Active members:      1,100
  Inactive members:    134
  Signups (7 days):    42
  Signups (30 days):   187

Members by Plan:
  Free Plan:           800
  Pro Plan:            300
  Enterprise:          100
  No Plan:             34

members export

Export all members to CSV or JSON.

memberstack members export [options]

Options

Option	Description	Default
`--format <format>`	Output format: `csv` or `json`	`json`
`--output <path>`	Output file path	`members.json` or `members.csv`

Examples

memberstack members export
memberstack members export --format csv --output members-backup.csv

Exported CSV files flatten nested fields with customFields.* and metaData.* prefixes.

members import

Import members from a CSV or JSON file.

memberstack members import --file <path>

Options

Option	Description	Required
`--file <path>`	Input file path (CSV or JSON)	Yes

File Format

Required fields: email, password

Optional fields: plans (comma-separated plan IDs), loginRedirect, customFields.*, metaData.*

Examples

memberstack members import --file members.csv
memberstack members import --file members.json

members bulk-update

Bulk update members from a CSV or JSON file.

memberstack members bulk-update --file <path> [options]

Options

Option	Description	Required
`--file <path>`	Input file with member updates	Yes
`--dry-run`	Preview changes without applying them	No

File Format

Required fields: id

Optional fields: email, loginRedirect, customFields.*, metaData.*

Examples

memberstack members bulk-update --file updates.csv
memberstack members bulk-update --file updates.csv --dry-run

members bulk-add-plan

Add a plan to multiple members at once.

memberstack members bulk-add-plan --plan <planId> --filter <filter> [options]

Options

Option	Description	Required
`--plan <planId>`	Plan ID to add (`pln_...`)	Yes
`--filter <filter>`	Member filter: `no-plan` or `all`	Yes
`--dry-run`	Preview without applying changes	No

Examples

memberstack members bulk-add-plan --plan pln_abc123 --filter no-plan
memberstack members bulk-add-plan --plan pln_abc123 --filter all --dry-run

members note

Update a member's note.

memberstack members note <id> [options]

Arguments

Argument	Description	Required
`id`	Member ID (`mem_...`)	Yes

Options

Option	Description
`--text <text>`	Note text (omit to clear the note)

Examples

memberstack members note mem_abc123 --text "VIP customer, handle with care"
memberstack members note mem_abc123

Members

How do I export all my members?

Can I bulk update members from a file?

How do I find members by custom field values?

What file format do I need for importing members?

On this page