User-related API environment
Pre-live user-related API docs
These pages describe the Pre-live user-related API stack.
Use pre-live OAuth credentials, pre-live API base URLs, and pre-live app URLs when following this documentation. Keep your OAuth flow, API requests, callback URLs, and manual testing within the pre-live environment.
- Use prelive.quran.com for auth-related testing.
- Use prelive.quranreflect.org for Quran Reflect paths where applicable.
- Do not mix production sessions or production user data with pre-live testing.
Create a new group
Create a new community group for sharing reflections. Groups can be Public, Closed, or Private, and the creator becomes the owner.
Request Body required
Group creation details including name, description, URL, and visibility
Deprecated content-visibility projection. Use privacy instead.
Possible values: non-empty and <= 50 characters
Possible values: <= 200 characters
Possible values: non-empty and <= 50 characters
Possible values: [public, closed, private]
- 201
- 400
- 401
Group created successfully
Schema
data object required
Deprecated content-visibility projection. Use privacy instead.
Possible values: [public, closed, private]
avatarUrls object required
Possible values: [none, pending]
{
"success": true,
"data": {
"id": 0,
"name": "string",
"description": "string",
"roomType": "string",
"isActive": true,
"isVerified": true,
"privacy": "public",
"hideFollowJoinButton": true,
"isOwner": true,
"isAdmin": true,
"ownerId": "string",
"postsCount": 0,
"membersCount": 0,
"url": "string",
"avatarUrls": {
"thumb": "string",
"original": "string"
},
"createdAt": "2026-10-12T09:27:01.979Z",
"isMember": true,
"subdomain": "string",
"country": "string",
"membershipRequestStatus": "none",
"pendingMembershipRequestsCount": 0
}
}
{
"success": true,
"data": {
"isPublic": true,
"id": 1,
"name": "string",
"description": "string",
"roomType": "string",
"isActive": true,
"isVerified": true,
"privacy": "public",
"hideFollowJoinButton": true,
"isOwner": true,
"isAdmin": true,
"ownerId": "string",
"postsCount": 1,
"membersCount": 1,
"url": "string",
"avatarUrls": {
"thumb": "string",
"original": "string"
},
"createdAt": "2026-04-02T00:00:00.000Z",
"isMember": true,
"subdomain": "string",
"country": "string",
"membershipRequestStatus": "none",
"pendingMembershipRequestsCount": 1
}
}
Invalid group data or URL already taken
User not authenticated