1. OAuth2
TrustWILL
  • Reviews Widget Integration
  • Reviews Data API
    • Trustoo Open API — Quick Start
    • OAuth2
      • OAuth2 Merchant Authorization
        GET
      • Get OAuth2 Authorization URL
        GET
      • OAuth2 Get / Refresh Access Token
        POST
      • Revoke Token
        POST
    • Platform Management
      • Disconnect Platform Authorization
      • Get Shop Authorization Info
      • Get Shop Installation Status
      • Cancel Platform Authorization
    • Webhooks
      • Create Shop Webhook
      • Update Shop Webhook
      • Delete Shop Webhook
      • Get Shop Webhooks
    • Reviews
      • Get Review Detail
      • Get Review List
      • Create Review
      • Delete Review
      • Get Rating
    • Media Upload
      • Get Video Upload URL
      • Get Image Upload Credentials
    • Orders
      • Get Order List
    • Customer Events
      • Get Customer Event List
    • Customers
      • Email Unsubscribe
      • Create Customer Exclusion
      • Delete Customer Exclusion
      • Get Customer Exclusion List
  • Schemas
    • SuccessResponse
    • ErrorResponse
    • Pagination
    • OAuthTokenRequest
    • Webhook
    • CreateReviewRequest
    • Review
    • Rating
    • Order
    • CustomerEvent
    • CustomerExclusion
    • ImageUploadCredentials
  1. OAuth2

OAuth2 Merchant Authorization

GET
/api/v1/openapi/oauth/authorize
Merchant-facing OAuth2 authorization endpoint. After the merchant logs into the Shopify store, they are redirected here to grant permissions to a third-party platform. This endpoint validates the request and redirects to the client's redirect_uri with an authorization code.
Authentication: JWT (shop merchant session)

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://rapi.trustoo.io/api/v1/openapi/oauth/authorize?client_id=trustwill&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Foauth%2Fcallback&state=abc123&scope=read_reviews%2Cwrite_reviews' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Error response (rendered as HTML for the merchant)
Bodyapplication/json

Example
{
    "code": 0,
    "reason_code": 0,
    "message": "string",
    "time": 0,
    "request_id": "string"
}
🔵302
Modified at 2026-06-24 04:25:21
Previous
Trustoo Open API — Quick Start
Next
Get OAuth2 Authorization URL
Built with