Skip to main content
Required fields in Ocular:
  • App Access Token – the Admin API access token from a Return Prime custom app
Follow the steps below to grab the access token and paste it into Data Management → Connectors → Add connector → Return Prime.

What you need

An App Access Token from a Return Prime custom app.

What it unlocks

Return-reason breakdown in Quickstart Reports → Sales, returns-by-SKU analysis, and refund attribution in the P&L.

​
Step 1 · Generate an App Access Token in Return Prime

Follow these steps to create a custom app and generate an access token.

Open Return Prime

Log in to your Return Prime dashboard.

Open Settings

Navigate to Settings at the bottom of the left sidebar.

Go to Integrations → Develop apps

Go to the Integrations section and click Develop apps.
RP Settings

Settings → Integrations

RP Developapps

Integrations → Develop apps

Create new app

Enter an app name (e.g., Ocular Analytics) and click Create app.
R Pcreateapp

Develop apps → Create new app

Open API credentials

Once the app is created, navigate to the API credentials tab and copy the access token
R Paccesstoken

API credentials → Admin API access token

Copy the Access Token

Copy the Access Token that appears.
Save this token securely elsewhere as you may only be able to view it once. If you lose the token, you’ll need to regenerate it from the custom app settings — all previous tokens will be invalidated.
If you ever lose the token, regenerate a fresh one from the app’s API credentials tab. All previous tokens will be invalidated.

​
Step 2 · Plug the credentials into Ocular

Open the connector form

In Ocular, navigate to Data Management → Connectors → Add connector → Return Prime.
RPOC

Add connector → Return Prime

Fill the fields

Connector Name

Free-form label.

Start Date

YYYY-MM-DD — how far back in time Ocular should pull data from your Return Prime account. Choose a date from which you want to begin analyzing your return and exchange data.

Lookback Days

The number of past days from which data will be fetched during synchronization. This ensures that recent historical data is included and kept up to date. Default is 30 days.

Auto Sync

Automatically triggers synchronization when the connector is enabled.

App Access Token

The token you just copied from Return Prime.
R Ppaste TokenR Ppaste Token

Return Prime connector form — paste the App Access Token

Create the connector

Click Create Connector. Ocular stores the token in its encrypted vault and triggers the first sync.
Success RP

Connector created — data will begin syncing shortly

​
Troubleshooting

Re-copy the token — watch for leading/trailing spaces. If the issue persists, regenerate the token from the custom app’s API credentials tab (this invalidates all previous tokens).
Open the custom app in Return Prime, go to API credentials, and click regenerate. Paste the new token into the Ocular connector form and re-save.
Increase Lookback Days — returns are often initiated weeks after the original purchase, especially during sale windows. 60–90 days is common for brands with long return policies.
For ticket-writing format when filing a connector issue, see Working with the Ocular team → Connector-not-working tickets.