Member Actions

The Admin Package provides powerful methods to manage members through your server-side code. This section covers the complete set of member management capabilities, including listing, creating, updating, and deleting members.

Before You Start

Make sure you've initialized the Admin Package with your secret key as shown in the Quick Start guide
Consider using test mode (sandbox) for development and testing
Be aware of API rate limits (25 requests per second).
- If you are hitting this limit, consider caching responses

List All Members

Retrieve a paginated list of members in your application.

The members.list() method allows you to fetch members with pagination support:

Response Structure:

💡 Tip:

For applications with large member bases, implement pagination best practices:

Use the limit parameter to control response size. The default is 50 and the max is 100
Store the endCursor value to continue paginating from where you left off
Check hasNextPage to determine if more members exist

Retrieve a Member

Get detailed information about a specific member by ID.

To fetch a single member by ID, use the members.retrieve() method:

Response:

The response contains the complete member data:

Error Handling

Handle cases where a member isn't found or other API errors occur:

Create a Member

Programmatically create new members in your application.

The members.create() method allows you to create new members with custom data and optional plan connections:

Required and Optional Parameters

Required:
- email - The member's email address
- password - The member's password
Optional:
- plans - Array of plan objects to connect
- customFields - Object containing custom data fields
- metaData - Object for internal metadata
- json - Object for complex JSON data
- loginRedirect - URL to redirect after login

⚠️ Important:

When creating members programmatically:

Always use strong passwords or implement passwordless options
Consider notifying members that their account has been created
For paid plans, use the DOM package's checkout flow instead

Update a Member

Modify existing member information using the Admin API.

Use the members.update() method to modify a member's information. Only the fields you include will be updated:

💡 Tip:

Tips for updating members:

Only include the fields you want to change
If you want to delete a custom field from a member, set it to null
You must use Memberstack's custom field ID format, which uses kebab-case with hyphens (like first-name) rather than camelCase (like firstName). Always use the exact string ID as shown in your Memberstack dashboard.
Consider implementing validation before updates
When updating email addresses, no verification email is sent by default - you may need to handle this manually

Delete a Member

Permanently remove a member from your application.

To delete a member, use the members.delete() method:

⚠️ Important:

Warning: Deleting a member is permanent and cannot be undone. Consider these precautions:

Implement confirmation steps before deletion
Backup important member data if needed
Consider using a "deactivated" flag instead of full deletion
Handle any dependent resources in your application

Add a Free Plan to a Member

Give a member access to a free plan programmatically.

To add a free plan to an existing member:

Important Notes

This method only works with free plans (plan IDs starting with "pln_")
For paid plans, use the DOM package's checkout flow
Members can have multiple plans simultaneously

Remove a Free Plan from a Member

Revoke access to a free plan programmatically.

To remove a free plan from a member:

💡 Tip:

When removing plans:

Consider notifying the member about plan changes
Handle any access control logic in your application
Update any relevant user interfaces to reflect plan status

Next Steps

Now that you understand member management, you might want to explore:

Need Help?

Having trouble getting your login working? We're here to help!

Join our Slack Community → Find a Memberstack Expert → Search the Help Center →