# Admin Signup Requests

Administrative endpoints for managing user signup requests. Provides tools for reviewing, approving, rejecting, and managing signup requests in moderation queue. Supports workflow for manual account approval when enabled.

## Approve a signup request

 - [PUT /api/v1/admin/signup_requests/approve/{hash}](https://docs.wellesley.social/openapi/admin-signup-requests/paths/~1api~1v1~1admin~1signup_requests~1approve~1%7Bhash%7D/put.md): Approves a pending signup request and creates the user account. Sends a welcome email to the user upon successful account creation. If username conflicts occur, sends an alternative email prompting the user to choose a different username. If email/phone conflicts occur, the request is deleted as the user likely already has an account. The operation is logged for audit purposes.

RBAC: requires Signups.Manage

## Delete a signup request

 - [DELETE /api/v1/admin/signup_requests/delete/{hash}](https://docs.wellesley.social/openapi/admin-signup-requests/paths/~1api~1v1~1admin~1signup_requests~1delete~1%7Bhash%7D/delete.md): Permanently removes a signup request from the system without notifying the user. Use this for cleaning up invalid, duplicate, or spam requests. Unlike rejection, this does not send any notification to the applicant. The request cannot be recovered after deletion.

RBAC: requires Signups.Manage

## List pending signup requests

 - [GET /api/v1/admin/signup_requests/list](https://docs.wellesley.social/openapi/admin-signup-requests/paths/~1api~1v1~1admin~1signup_requests~1list/get.md): Retrieves a paginated list of signup requests awaiting admin approval. Can filter by email address, request hash, or originating IP address. Results are sorted by creation date (newest first) by default. Only shows requests at the ADMIN approval step.

RBAC:
- requires ANY of Signups.Read, Signups.Manage

## Reject a signup request

 - [PUT /api/v1/admin/signup_requests/reject/{hash}](https://docs.wellesley.social/openapi/admin-signup-requests/paths/~1api~1v1~1admin~1signup_requests~1reject~1%7Bhash%7D/put.md): Rejects a pending signup request and permanently removes it from the queue. Sends a rejection email to the applicant with an optional reason for the rejection. This action is final and the user would need to submit a new signup request. The rejection is logged for audit purposes.

RBAC: requires Signups.Manage