Included in: Grammarly Enterprise and Grammarly for Education plans
Managed by: Admins
Grammarly API uses OAuth 2.0 protocol for secure integration with third-party applications.
To receive OAuth credentials for your application, follow these steps:
- Go to your Admin panel.
- Open the Organization tab and choose OAuth 2.0 credentials in the Configurations section:
- On the next page, click Add credential in the upper-right corner.
- In the window that appears, enter a name and check the box next to the API you will use.
- Click Create.
- Next, click Copy to clipboard to save your Client ID and Secret.
Overview of OAuth scopes
Grammarly’s OAuth credentials can be assigned OAuth scopes, which are features that define the specific permissions granted to an OAuth client when accessing the Grammarly API. OAuth scopes limit access to only necessary resources, enhancing security by minimizing granted permissions.
Each OAuth client can be assigned the following scopes:
Provides read-only access to the Writing Score API, allowing applications to retrieve writing scores for submitted text.
Suitable for applications that evaluate or analyze text quality, offering insights like writing clarity, engagement, and overall score.
Provides write access to the Writing Score API, enabling applications to submit documents for writing score evaluations.
Suitable for applications that evaluate or analyze text quality, offering insights like writing clarity, engagement, and overall score.
Grants read-only access to the Analytics API, which provides Grammarly usage statistics for team plan members, including metrics like the number of writing sessions, the percentage of improved writing sessions, and generative AI prompt usage.
This scope is commonly used by BI applications or analytical dashboards that show engagement with Grammarly.
To learn how to authenticate a client and make API requests to Grammarly using OAuth credentials, review the API documentation.