Implement the EULA acceptance gate and webhook-based completion flow for Turnitin Core API (Similarity/TCA) submissions

domain: developers.turnitin.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. After configuring the Turnitin URL and API key, call the Get Features Enabled request and check the returned tenant.require_eula flag to know whether your integration must show users a EULA before submitting.
  2. If require_eula is true, call Get EULA Version Info with version_id=latest to get the current EULA version, then Get EULA Page to retrieve the EULA HTML (or use its static url) for display.
  3. Before creating a submission, confirm the user has accepted the current EULA version; if not, show it and block submission until accepted, then pass the optional eula attributes on the Create Submission request.
  4. Poll Get EULA Version Info roughly every 24 hours to detect a newly published EULA version, and re-prompt any user who hasn't accepted the new version.
  5. Register for and consume webhooks for submission-complete and similarity-report-complete events instead of tight polling; fall back to polling the corresponding status endpoint only if no webhook arrives within about 30 minutes.

Known gotchas

Related routes

Automate plagiarism check submission and result retrieval via Turnitin's API
turnitin.com · 5 steps · unrated
Implement a reliable webhook processing pipeline with verification, deduplication, fast ack, and polling fallback
payments-general · 6 steps · unrated
Implement FDX v6 FAPI 2.0 Pushed Authorization Request (PAR) and PKCE for a data aggregator consent flow
banking-general · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans