Back to guide
Integrations
Bring records in and connect external tools safely
TheProfitPath supports CSV analysis and import, Notion OAuth imports, and developer API keys or OAuth connections for ongoing programmatic access.
- Sections
- 5
- Reading time
- 2 min
- Opens in app
- Integrations
CSV imports
Open Trades → Import → CSV, choose one or more CSV files, then select Analyze file. Review the detected trades, mapped fields and validation issues, select the rows you want, then select Import trades to save them. Analysis alone does not add trades to your journal; you can close the dialog and resume a saved analysis. API imports use the trades resource and require write:trades.
Notion
Connect Notion from Settings → Integrations through the signed-in OAuth flow. Open Trades → Import → Notion to search the pages you authorized, analyze selected content, and review supported trading records before saving. OAuth connection controls remain browser-session only.
Notion import stuck or interrupted
A percentage such as 80% measures completed analysis batches; it does not identify an error or guarantee a time remaining. Check the status text beside it: Analyzing batch means a batch is still running, Waiting for AI capacity means processing is waiting for capacity, and Reading source attachments tracks attachment work separately. If the dialog loses its connection or you close it, reopen Trades → Import → Notion and find the same item under Saved analyses. Choose Resume for unfinished work or Review trades for a completed analysis. Reopen the existing saved analysis rather than starting another copy or disconnecting Notion. Analysis alone does not save trades. If the same batch stays unchanged or an error returns, give support the status text, how long it has been unchanged, and any exact error; the percentage alone cannot establish the cause. Keep the browser tab open during the later Import trades saving step.
Developer API
Create personal or organization-labelled API keys in Settings → Developer. Read-only keys retrieve documented resources; read/write keys can also make documented mutations. New keys expire after 30, 90, or 365 days. The raw secret is displayed once and stored only as a hash afterward. For other users, register an OAuth app in the same Developer settings; each person approves scopes and can revoke access in Connected apps. The Usage tab charts each key's requests, and the API reference tab lists every endpoint and can send read requests with a pasted key.
Choose the narrowest path
Use CSV for one-time files, Notion for user-directed workspace imports, and the API for a maintained integration. Store API keys in a secret manager, never a browser bundle or query string, and revoke them when no longer needed.
Integration paths
One-time imports and ongoing connections.