Onboarding
The Pitch Mentor API lets you integrate your CRM, pull call analytics, and automate workflows. All endpoints require authentication.
Getting Started
- 1Sign in to your Pitch Mentor dashboard at pitchmentor.net/dashboard
- 2Navigate to Settings → CRM Integration
- 3Click Generate API Key and save it securely
- 4Use the API key in the
X-API-Keyheader for all CRM integration requests
Authentication Methods
| Method | Use Case | Header |
|---|---|---|
| API Key | All endpoints (CRM, analytics, exports) | X-API-Key: pm_live_... |
API Key Authentication
For CRM integrations (pushing leads into Pitch Mentor), use an API key:
curl https://api.pitchmentor.net/crm/v1/leads \
-H "X-API-Key: pm_live_your_key_here" \
-H "Content-Type: application/json"Using Your API Key
All endpoints (CRM, analytics, and exports) use the same API key authentication:
curl https://api.pitchmentor.net/analytics/me \
-H "X-API-Key: pm_live_your_key_here"Base URL
All API endpoints use the base URL: https://api.pitchmentor.net
Rate Limits
| Endpoint Type | Limit |
|---|---|
| CRM Integration | 100 requests/minute |
| Analytics & Export | 100 requests/minute |
Lead Pulling (CRM Integration)
Push your CRM data into Pitch Mentor so your reps get real-time lead context during calls. Works with any CRM — Salesforce, HubSpot, Pipedrive, Close, and more.
How It Works
- 1Generate an API key from Settings → CRM Integration
- 2POST your leads to our API from your CRM
- 3Leads appear automatically during calls by phone match
Create or Update a Lead
/crm/v1/leadsIf externalId is provided and a lead with that ID already exists, it will be updated (upsert).
curl -X POST https://api.pitchmentor.net/crm/v1/leads \
-H "X-API-Key: pm_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"externalId": "sf_00Q1234567",
"source": "salesforce",
"name": "Jane Smith",
"phone": "+1-555-867-5309",
"email": "[email protected]",
"company": "Acme Corp",
"stage": "QUALIFIED",
"value": 15000,
"description": "Interested in enterprise plan"
}'Request Fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Lead's full name |
phone | string | Yes | Phone number (any format) |
externalId | string | No | Your CRM's unique ID |
source | string | No | CRM name (e.g., "salesforce") |
email | string | No | Email address |
company | string | No | Company name |
stage | string | No | Deal stage |
value | number | No | Deal value (USD) |
description | string | No | Notes or context |
Batch Import
/crm/v1/leads/batchImport up to 100 leads at once. Same upsert logic applies per lead.
curl -X POST https://api.pitchmentor.net/crm/v1/leads/batch \
-H "X-API-Key: pm_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"leads": [
{
"name": "Alice Johnson",
"phone": "+15551234567",
"company": "Startup Inc",
"stage": "NEW"
},
{
"name": "Bob Williams",
"phone": "+15559876543",
"company": "Big Corp",
"stage": "QUALIFIED"
}
]
}'Response Format
{
"success": true,
"lead": {
"id": "uuid",
"externalId": "sf_00Q1234567",
"name": "Jane Smith",
"phone": "+1-555-867-5309",
"company": "Acme Corp"
}
}Common Integration Patterns
Webhook Sync
Configure your CRM to send a webhook when leads are created/updated. POST the payload to our API.
Scheduled Sync
Run a cron job every hour to query your CRM for new/updated leads and batch import them.
Real-time Push
Add API calls to your CRM workflows or automations to push leads as they're created.
Analytics Pulling
Pull your call data, transcripts, and analytics programmatically. Perfect for building custom dashboards, exporting to spreadsheets, or integrating with your analytics stack.
Personal Analytics
/analytics/meGet comprehensive analytics for your calls including trends, outcomes, objections, and personal bests.
Query Parameters
period: 7d | 30d | 90d | all (default: 30d)format: summary | detailed (default: summary)
curl https://api.pitchmentor.net/analytics/me?period=30d&format=detailed \
-H "X-API-Key: pm_live_your_key_here"Individual Call Data
/calls/:id/dataGet complete data for a single call including full transcript, coaching logs, and CRM lead information.
curl https://api.pitchmentor.net/calls/CALL_ID/data \
-H "X-API-Key: pm_live_your_key_here"Bulk Call Export
/calls/exportExport your calls in CSV or JSON format with advanced filtering options.
Query Parameters
format: csv | json (default: csv)from: ISO date (YYYY-MM-DD)to: ISO date (YYYY-MM-DD)callType: set | closeroutcome: interested | not_interested | etc.limit: max records (default: 1000, max: 10000)
# Export as JSON with filters
curl "https://api.pitchmentor.net/calls/export?format=json&from=2026-01-01&to=2026-02-01" \
-H "X-API-Key: pm_live_your_key_here" \
-o calls.json
# Export as CSV
curl "https://api.pitchmentor.net/calls/export?format=csv" \
-H "X-API-Key: pm_live_your_key_here" \
-o calls.csvTeam Member Analytics (Admin Only)
/analytics/user/:userIdTeam admins can view detailed analytics for any team member. Requires admin role.
curl https://api.pitchmentor.net/analytics/user/USER_ID?period=30d \
-H "X-API-Key: pm_live_your_key_here"CSV Export Fields
When exporting as CSV, the following fields are included:
| Field | Description |
|---|---|
ID | Call UUID |
Date | Call start timestamp (ISO 8601) |
Duration (s) | Call duration in seconds |
Platform | tab | phone | app |
Call Type | set | closer |
Prospect Name | Lead name from CRM |
Prospect Phone | Lead phone number |
Prospect Company | Lead company |
Coaching Tips | Number of coaching cards shown |
Outcome | Call outcome |
Call Score | AI score (0-100) |
Talk Ratio | Rep talk percentage |
Summary | AI-generated call summary |
Use Cases
Custom Dashboards
Fetch analytics data and build your own visualization dashboards with tools like Tableau, Power BI, or custom React apps.
Spreadsheet Analysis
Export calls to CSV and analyze performance trends in Excel or Google Sheets.
Data Warehouse Integration
Pull call data into your data warehouse (Snowflake, BigQuery, etc.) for company-wide analytics.
Automated Reporting
Schedule weekly exports and automatically generate performance reports for your team.
Call Review Tools
Build custom tools to review transcripts and coaching suggestions for training purposes.
Questions? Reach out at [email protected]