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.
Go to Integrations → Develop apps
Go to the Integrations section and click Develop apps.
Settings → Integrations
Integrations → Develop apps
Create new app
Click Create new app.Enter an app name (e.g., Ocular Analytics) and click Create app.
Create new app
Click Create new app.
Develop apps → Create new app
Enter an app name (e.g., Ocular Analytics) and click Create app.
Open API credentials
Once the app is created, navigate to the API credentials tab.
Open API credentials
Once the app is created, navigate to the API credentials tab and copy the access token
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.
In Ocular, navigate to Data Management → Connectors → Add connector → Return Prime.
Open the connector form
In Ocular, navigate to Data Management → Connectors → Add connector → Return Prime.
Add connector → Return Prime
Fill the fields
Connector Name
Free-form label.
Connector Identifier
Auto-generated by Ocular.
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.
Schedule Frequency
Defines how often the connector will automatically sync data. Configured using a numeric value (frequency) along with a time unit (e.g., hours), determining the interval between each sync cycle.
Auto Sync
Automatically triggers synchronization when the connector is enabled.
App Access Token
The token you just copied from Return Prime.
Fill the fields
Connector Name
Free-form label.
Connector Identifier
Auto-generated by Ocular.
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.
Schedule Frequency
Defines how often the connector will automatically sync data. Configured using a numeric value (frequency) along with a time unit (e.g., hours), determining the interval between each sync cycle.
Auto Sync
Automatically triggers synchronization when the connector is enabled.
App Access Token
The token you just copied from Return Prime.
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.
Create the connector
Click Create Connector. Ocular stores the token in its encrypted vault and triggers the first sync.
Connector created — data will begin syncing shortly
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).
Lost the token
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.
Returns missing from older orders
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.
