"Request API Access" form returns 500 "Failed to process registration" on submit
complete
Mohamad Safwan
The Request API Access form at https://api-docs.quran.foundation/request-access/
fails on submit with a server error, so it's impossible to obtain API credentials.
1. Operating system: Windows 11
2. The browser: Chrome Version 149.0.7827.103 (Official Build) (64-bit)
3. Screenshots of the bug: (attached)
- The filled-in form
- DevTools → Network showing the failed request:
Request URL: https://qf-form-handler.fly.dev/api/v1/webhook
Request Method: POST
Status Code: 500 Internal Server Error
Response body: {"error":"Failed to process registration"}
4. Steps to reproduce:
b. Fill the required fields only — App Name and Email — and tick the
"I have read and agree…" checkbox. Leave all the optional OAuth2 fields
(Redirect URIs, Logo/Client/Privacy/Terms URLs, Post-logout URIs) blank.
c. Click "Submit Request".
d. The POST to qf-form-handler.fly.dev/api/v1/webhook returns HTTP 500 with
{"error":"Failed to process registration"}. No application record is created.
Example payload:
{
"appName": "BetterMuslim",
"email": "mohamadsafwan.1905@gmail.com",
"agreementsAccepted": true
}
Additional notes:
- This is a server-side 500 (not a validation 4xx). It reproduces even with a
truly minimal payload — only the required fields:
{"appName":"<app>","email":"<email>","agreementsAccepted":true}
…so it is not input-dependent; the form handler appears to throw unhandled.
- We only need server-to-server content access (client_credentials, scope=content),
so no redirect URIs are provided — in case the handler errors when an OAuth
client is created without redirect URIs.
Impact: blocks new developers from registering for any API access.
Photo Viewer
View photos in a modal
Quran.com Feedback Team
updated the status to
complete
Quran.com Feedback Team
Jazakum Allahu khairan Mohamad Safwan for reporting this. The issue has now been resolved. Please try again and let us know if you encounter any issues.
Quran.com Feedback Team
Assalamu Alaikum Dear Mohamad Safwan,
Jazakum Allahu Khairan for bringing this issue to our attention!
Our engineering team has been notified and will work to resolve the issue, insha'Allah.
We truly appreciate your dedication to the Book of Allah, and please don’t hesitate to share any further observations.
Thanks,
Quran.com Feedback Team
Mohamad Safwan
Waalaikummussalam, dear Quran.com Feedback Team,
Jazakum Allahu khairan for the quick response and for looking into it — much appreciated. I'll keep an eye out and share anything else I come across, in shaa Allah. May Allah reward your team for your service to the Book of Allah.
Best regards,
Mohamad Safwan