API Reference
Open API playground Send live requests from your browser.
The Dialer API lets you integrate FreJun's business communication capabilities directly into your applications. Build custom calling and messaging workflows, manage users, teams, contacts, and virtual numbers, access call data and analytics, and receive real-time updates through webhooks.
All endpoints are served over HTTPS from https://api.frejun.com and accept/return JSON.
Authenticate your requests using your secret API key or Bearer token in the Authorization header:
curl https://api.frejun.com/api/v2/integrations/calls/ \
-H "Authorization: Bearer $OAUTH_TOKEN"
OR
curl https://api.frejun.com/api/v2/integrations/calls/ \
-H "Authorization: Api-Key $API_KEY"
Core Capabilities
- Calling & Analytics: Manage calls, access call logs and recordings, and work with outcomes, reasons, notes, and tags.
- Users & Numbers: Manage users, roles, and virtual numbers for inbound and outbound calling.
- Contacts & Autodialing: Create contact lists and build targeted calling and autodialing workflows.
- WhatsApp Business: Send messages, manage templates, and track message status.
- Webhooks: Receive real-time updates for calls and messaging events and keep your systems in sync.
Keys are account-scoped and grant extensive access — treat them like passwords and always keep them server-side. A missing or invalid token will return 401 Unauthorized.
Looking for step-by-step guides? Comprehensive guides for core concepts, webhooks, WhatsApp integrations, and more are available in the main FreJun Dialer Documentation.
Authentication
Authenticate your application and create, refresh, or verify OAuth access tokens.
- GET Generate OAuth tokens (GET)
/api/v2/oauth/token/ - POST Generate OAuth tokens (POST)
/api/v2/oauth/token/ - POST Verify OAuth tokens
/api/v2/oauth/verify-token/ - POST Refresh OAuth tokens
/api/v2/oauth/token/refresh/
User Management
Create and manage users, roles, licenses, calling access, and user settings.
- GET Get all users
/api/v2/integrations/users/ - POST Create user
/api/v2/integrations/users/ - GET Retrieve a user
/api/v2/integrations/user/ - PATCH Update a user
/api/v2/integrations/user/ - DELETE Delete a user
/api/v2/integrations/user/ - GET List roles
/api/v2/integrations/roles/
Account Management
Manage account-level calling attributes such as outcomes, reasons, and tags.
- GET List Call Dispositions
/api/v2/integrations/organization-detail-api/ - POST Add Call Dispositions
/api/v2/integrations/organization-detail-api/ - PATCH Delete call dispositions
/api/v2/integrations/organization-detail-api/
Webhooks
Configure webhooks and receive real-time events from your FreJun account.
- POST Create a webhook
/api/v2/integrations/create-webhook/ - GET Retrieve a webhook
/api/v2/integrations/webhook/{hook_id}/ - PATCH Update a webhook
/api/v2/integrations/webhook/{hook_id}/ - DELETE Delete a webhook
/api/v2/integrations/webhook/{hook_id}/ - GET List webhooks
/api/v2/integrations/webhooks/
Calling
Make and receive calls, access call logs and analytics, manage call attributes, and build calling workflows.
- GET List call logs
/api/v2/integrations/calls/ - PATCH Update a call log
/api/v2/integrations/update-call-log/ - GET Retrieve call analytics
/api/v2/integrations/call-analytics/
Contact Lists
Create and manage contacts and lists for calling campaigns and autodialing workflows.
- GET Retrieve contact lists
/api/v2/integrations/contact-list/ - POST Create a contact list
/api/v2/integrations/contact-list/ - PATCH Update a contact list
/api/v2/integrations/contact-list/ - DELETE Delete a contact list
/api/v2/integrations/contact-list/ - PATCH Assign contacts
/api/v2/integrations/assign-contact/ - PATCH Unassign contacts
/api/v2/integrations/unassign-contact/
Virtual Number Management
View and assign virtual numbers for inbound and outbound calling.
- GET List virtual numbers
/api/v2/integrations/retrieve-virtual-numbers/ - POST Assign or unassign virtual numbers
/api/v2/integrations/assign-virtual-numbers/