# Bavlio

> Agent-first sales outreach API. Build with Bavlio from a single bav_live_ API key — no human-in-the-loop friction.

## Docs

- [Agent Chat](https://docs.bavlio.com/api-reference/agent/agent-chat.md): SSE streaming endpoint for the unified Bavi agent.
- [Archive Conversation](https://docs.bavlio.com/api-reference/agent/archive-conversation.md): Archive (soft-delete) a conversation.
- [Create Conversation](https://docs.bavlio.com/api-reference/agent/create-conversation.md): Create a new conversation.
- [Get Conversation](https://docs.bavlio.com/api-reference/agent/get-conversation.md): Get a conversation with its messages.
- [Get Pending Interrupt](https://docs.bavlio.com/api-reference/agent/get-pending-interrupt.md): Check if a conversation has a pending interrupt (for browser reopen).
- [List Conversations](https://docs.bavlio.com/api-reference/agent/list-conversations.md): List user's non-archived conversations, newest first.
- [Create Api Key](https://docs.bavlio.com/api-reference/api-keys/create-api-key.md): Create a new API key. Returns the raw key exactly once.
- [List Api Keys](https://docs.bavlio.com/api-reference/api-keys/list-api-keys.md): List all active API keys for the authenticated user.
- [Revoke Api Key](https://docs.bavlio.com/api-reference/api-keys/revoke-api-key.md): Revoke an API key. The key is soft-deleted and immediately invalidated.
- [Get Current User](https://docs.bavlio.com/api-reference/authentication/get-current-user.md): Get current user information.
- [Send Welcome Email](https://docs.bavlio.com/api-reference/authentication/send-welcome-email.md): Send a welcome email to a newly signed-up user.
- [Verify Token](https://docs.bavlio.com/api-reference/authentication/verify-token.md): Verify JWT token and return user information.
- [Add Domain](https://docs.bavlio.com/api-reference/bavimail-proxy/add-domain.md)
- [Cancel Email](https://docs.bavlio.com/api-reference/bavimail-proxy/cancel-email.md)
- [Check Dns Status](https://docs.bavlio.com/api-reference/bavimail-proxy/check-dns-status.md)
- [Create Alias](https://docs.bavlio.com/api-reference/bavimail-proxy/create-alias.md)
- [Delete Alias](https://docs.bavlio.com/api-reference/bavimail-proxy/delete-alias.md)
- [Delete Domain](https://docs.bavlio.com/api-reference/bavimail-proxy/delete-domain.md)
- [Delete Inbound Email](https://docs.bavlio.com/api-reference/bavimail-proxy/delete-inbound-email.md)
- [Download Inbound Attachment](https://docs.bavlio.com/api-reference/bavimail-proxy/download-inbound-attachment.md)
- [Get Alias](https://docs.bavlio.com/api-reference/bavimail-proxy/get-alias.md)
- [Get Conversation](https://docs.bavlio.com/api-reference/bavimail-proxy/get-conversation.md)
- [Get Domain](https://docs.bavlio.com/api-reference/bavimail-proxy/get-domain.md)
- [Get Domain Setup](https://docs.bavlio.com/api-reference/bavimail-proxy/get-domain-setup.md)
- [Get Email](https://docs.bavlio.com/api-reference/bavimail-proxy/get-email.md)
- [Get Email Clicks](https://docs.bavlio.com/api-reference/bavimail-proxy/get-email-clicks.md)
- [Get Email Links](https://docs.bavlio.com/api-reference/bavimail-proxy/get-email-links.md)
- [Get Inbound Email](https://docs.bavlio.com/api-reference/bavimail-proxy/get-inbound-email.md)
- [Get Inbound Email Raw](https://docs.bavlio.com/api-reference/bavimail-proxy/get-inbound-email-raw.md)
- [List Aliases](https://docs.bavlio.com/api-reference/bavimail-proxy/list-aliases.md)
- [List Conversations](https://docs.bavlio.com/api-reference/bavimail-proxy/list-conversations.md)
- [List Domains](https://docs.bavlio.com/api-reference/bavimail-proxy/list-domains.md)
- [List Emails](https://docs.bavlio.com/api-reference/bavimail-proxy/list-emails.md)
- [List Inbound Emails](https://docs.bavlio.com/api-reference/bavimail-proxy/list-inbound-emails.md)
- [Send Email](https://docs.bavlio.com/api-reference/bavimail-proxy/send-email.md)
- [Update Alias](https://docs.bavlio.com/api-reference/bavimail-proxy/update-alias.md)
- [Update Domain](https://docs.bavlio.com/api-reference/bavimail-proxy/update-domain.md)
- [Verify Domain](https://docs.bavlio.com/api-reference/bavimail-proxy/verify-domain.md)
- [Re-register BaviMail webhook for the calling tenant](https://docs.bavlio.com/api-reference/bavimail-self-service/re-register-bavimail-webhook-for-the-calling-tenant.md): Force a fresh `ensure_webhook` round-trip for the calling user. Idempotent: if BaviMail already has an active+verified webhook, returns it as `already_active` without recreating. If a previously registered webhook is dead (consecutive_failures>=5, disabled_at set, or is_active=false), it is deleted…
- [Personalize Campaign Email](https://docs.bavlio.com/api-reference/campaign-personalization/personalize-campaign-email.md): Generate personalized email content for a campaign lead.
- [Preview Template Substitution](https://docs.bavlio.com/api-reference/campaign-personalization/preview-template-substitution.md): Preview template variable substitution without personalization.
- [Create Campaign](https://docs.bavlio.com/api-reference/campaigns/create-campaign.md): Create a new email campaign.
- [Delete Campaign](https://docs.bavlio.com/api-reference/campaigns/delete-campaign.md): Delete a campaign.
- [Get Aggregate Stats](https://docs.bavlio.com/api-reference/campaigns/get-aggregate-stats.md): Get aggregate stats across all user campaigns.
- [Get Campaign](https://docs.bavlio.com/api-reference/campaigns/get-campaign.md): Get a specific campaign by ID.
- [Get Campaign Click Stats](https://docs.bavlio.com/api-reference/campaigns/get-campaign-click-stats.md): Get click tracking stats for a campaign.
- [Get Campaign Stats](https://docs.bavlio.com/api-reference/campaigns/get-campaign-stats.md): Get comprehensive stats for a single campaign.
- [Get Launch Warnings](https://docs.bavlio.com/api-reference/campaigns/get-launch-warnings.md): Retrieve persisted launch warnings for a campaign.
- [Get Lead Events](https://docs.bavlio.com/api-reference/campaigns/get-lead-events.md): Get email event timeline for a specific campaign lead.
- [Get Step Performance](https://docs.bavlio.com/api-reference/campaigns/get-step-performance.md): Get per-step performance breakdown for a campaign.
- [Launch Campaign](https://docs.bavlio.com/api-reference/campaigns/launch-campaign.md): Launch a campaign.
- [Launch Preflight](https://docs.bavlio.com/api-reference/campaigns/launch-preflight.md): Check launch readiness without side effects.
- [List Campaign Leads](https://docs.bavlio.com/api-reference/campaigns/list-campaign-leads.md): List leads for a campaign with their current status.
- [List Campaigns](https://docs.bavlio.com/api-reference/campaigns/list-campaigns.md): List all campaigns for the authenticated user.
- [Pause Campaign](https://docs.bavlio.com/api-reference/campaigns/pause-campaign.md): Pause an active campaign.
- [Resume Campaign](https://docs.bavlio.com/api-reference/campaigns/resume-campaign.md): Resume a paused campaign.
- [Update Campaign](https://docs.bavlio.com/api-reference/campaigns/update-campaign.md): Update a campaign.
- [Get Capabilities](https://docs.bavlio.com/api-reference/capabilities/get-capabilities.md): Return current capability flags. Called on frontend boot + SPA refocus.
- [Check Connect Status](https://docs.bavlio.com/api-reference/connected-accounts/check-connect-status.md): Poll whether an IN_APP_VALIDATION account is ready.
- [Claim Connected Account](https://docs.bavlio.com/api-reference/connected-accounts/claim-connected-account.md): Free a LinkedIn slug previously connected by another user.
- [Connect Account](https://docs.bavlio.com/api-reference/connected-accounts/connect-account.md): Connect a LinkedIn account via username/password.
- [Connect Account Cookie](https://docs.bavlio.com/api-reference/connected-accounts/connect-account-cookie.md): Connect a LinkedIn account via browser cookie (li_at).
- [Create Auth Link](https://docs.bavlio.com/api-reference/connected-accounts/create-auth-link.md): Generate a hosted auth URL to connect a LinkedIn account.
- [Disable Connected Account](https://docs.bavlio.com/api-reference/connected-accounts/disable-connected-account.md): Soft-disable a connected account (sets status to 'disconnected').
- [Get Account Health](https://docs.bavlio.com/api-reference/connected-accounts/get-account-health.md): Get health indicators for a connected LinkedIn account.
- [Get Connected Account](https://docs.bavlio.com/api-reference/connected-accounts/get-connected-account.md): Get a single connected account by ID.
- [List Connected Accounts](https://docs.bavlio.com/api-reference/connected-accounts/list-connected-accounts.md): List all connected accounts for the current user.
- [Resume Rate Limited Account](https://docs.bavlio.com/api-reference/connected-accounts/resume-rate-limited-account.md): Resume a rate-limited LinkedIn account. Reactivates frozen leads.
- [Solve Checkpoint Endpoint](https://docs.bavlio.com/api-reference/connected-accounts/solve-checkpoint-endpoint.md): Solve a 2FA/OTP checkpoint to complete account connection.
- [Update Account Limits](https://docs.bavlio.com/api-reference/connected-accounts/update-account-limits.md): Update daily limits for a connected account.
- [Estimate Credits](https://docs.bavlio.com/api-reference/credits/estimate-credits.md): Estimate credit cost for an operation without consuming credits.
- [Get Credit Balance](https://docs.bavlio.com/api-reference/credits/get-credit-balance.md): Get current user's credit balance and package information.
- [Get Credit Transactions](https://docs.bavlio.com/api-reference/credits/get-credit-transactions.md): Get credit transaction history for the current user.
- [Archive a dataset](https://docs.bavlio.com/api-reference/datasets/archive-a-dataset.md): Soft-delete a dataset by setting archived_at timestamp
- [Download dataset in specified format](https://docs.bavlio.com/api-reference/datasets/download-dataset-in-specified-format.md): Download dataset rows in CSV, Excel, or JSON format with download tracking
- [List datasets with pagination](https://docs.bavlio.com/api-reference/datasets/list-datasets-with-pagination.md): Server-side paginated dataset listing with optional pipeline type filter and search
- [Restore an archived dataset](https://docs.bavlio.com/api-reference/datasets/restore-an-archived-dataset.md): Un-archive a dataset by clearing archived_at timestamp
- [Update dataset metadata](https://docs.bavlio.com/api-reference/datasets/update-dataset-metadata.md): Update dataset fields like dataset_name
- [Bulk Search](https://docs.bavlio.com/api-reference/email-finder/bulk-search.md): Bulk find: 3 credits/row, full SMTP+BaviMail verification.
- [Find Email](https://docs.bavlio.com/api-reference/email-finder/find-email.md): Find someone's email by trying patterns via sequential SMTP verification.
- [Get Bulk Status](https://docs.bavlio.com/api-reference/email-finder/get-bulk-status.md): Aggregated bulk status. `?include_rows=false` returns counts only.
- [Get Company](https://docs.bavlio.com/api-reference/email-finder/get-company.md): Get company profile + email patterns by domain.
- [Get Stats](https://docs.bavlio.com/api-reference/email-finder/get-stats.md): Get email finder database statistics.
- [Get Verification Status](https://docs.bavlio.com/api-reference/email-finder/get-verification-status.md): Poll for find or verify job status.
- [Health Check](https://docs.bavlio.com/api-reference/email-finder/health-check.md): Email finder health check — verifies database connectivity.
- [Search Person](https://docs.bavlio.com/api-reference/email-finder/search-person.md): Search for a B2B contact by name + company/domain.
- [Verify Email](https://docs.bavlio.com/api-reference/email-finder/verify-email.md): Verify an email address via SMTP + BaviMail.
- [Prune Dataset By Risk](https://docs.bavlio.com/api-reference/email-verification/prune-dataset-by-risk.md): Delete rows above a risk threshold and re-index remaining rows.
- [Validate Email](https://docs.bavlio.com/api-reference/email-verification/validate-email.md): Validate a single email address and return risk assessment.
- [Verify Dataset Emails](https://docs.bavlio.com/api-reference/email-verification/verify-dataset-emails.md): Verify all emails in a dataset and return per-row risk results.
- [Get Enrichment Status](https://docs.bavlio.com/api-reference/enrichment-chat/get-enrichment-status.md): Get the current status of enrichment processing.
- [Get Session File Data](https://docs.bavlio.com/api-reference/enrichment-chat/get-session-file-data.md): Get file data from a session for enrichment.
- [Notify File Uploaded](https://docs.bavlio.com/api-reference/enrichment-chat/notify-file-uploaded.md): Notify the chat session that a file has been uploaded.
- [Send Enrichment Message](https://docs.bavlio.com/api-reference/enrichment-chat/send-enrichment-message.md): Send a message in the enrichment chat session with enhanced processing.
- [Start Enrichment Chat](https://docs.bavlio.com/api-reference/enrichment-chat/start-enrichment-chat.md): Start a new enrichment chat interface with enhanced initialization.
- [Get Enrichment Job Status](https://docs.bavlio.com/api-reference/enrichment-processing/get-enrichment-job-status.md): Get the comprehensive status of an enrichment job.
- [Process File Enrichment](https://docs.bavlio.com/api-reference/enrichment-processing/process-file-enrichment.md): Process file enrichment request from the agent.
- [Submit Feedback](https://docs.bavlio.com/api-reference/feedback/submit-feedback.md): Submit user feedback with optional screenshot and attachments.
- [Preview CSV or Excel file before upload](https://docs.bavlio.com/api-reference/file-upload-csvexcel/preview-csv-or-excel-file-before-upload.md): Upload a CSV or Excel file to preview its structure, columns, and sample data
- [Preview Excel file sheets](https://docs.bavlio.com/api-reference/file-upload-csvexcel/preview-excel-file-sheets.md): Upload an Excel file to preview all sheets with metadata and sample data
- [Upload CSV with sender profile support](https://docs.bavlio.com/api-reference/file-upload-csvexcel/upload-csv-with-sender-profile-support.md): Upload CSV file with option to use saved sender profiles or create new ones
- [Upload Excel with multi-sheet and sender profile support](https://docs.bavlio.com/api-reference/file-upload-csvexcel/upload-excel-with-multi-sheet-and-sender-profile-support.md): Upload Excel file with option to process multiple sheets, use saved sender profiles, or create new ones
- [Get Google Access Token](https://docs.bavlio.com/api-reference/google-oauth/get-google-access-token.md): Get the current Google OAuth access token for the user.
- [Get Picker Config](https://docs.bavlio.com/api-reference/google-oauth/get-picker-config.md): Get Google Picker API configuration for frontend.
- [Google Oauth Callback](https://docs.bavlio.com/api-reference/google-oauth/google-oauth-callback.md): Handle Google OAuth callback.
- [Google Oauth Login](https://docs.bavlio.com/api-reference/google-oauth/google-oauth-login.md): Initiate Google OAuth flow.
- [Google Oauth Logout](https://docs.bavlio.com/api-reference/google-oauth/google-oauth-logout.md): Revoke Google OAuth credentials.
- [Google Oauth Status](https://docs.bavlio.com/api-reference/google-oauth/google-oauth-status.md): Get Google OAuth authentication status.
- [Get Sheet Info](https://docs.bavlio.com/api-reference/google-sheets-oauth/get-sheet-info.md): Get metadata about a Google Sheet.
- [Grant Sheet Access](https://docs.bavlio.com/api-reference/google-sheets-oauth/grant-sheet-access.md): Grant and record access to a Google Sheet selected via Google Picker.
- [Import Google Sheets As Extraction](https://docs.bavlio.com/api-reference/google-sheets-oauth/import-google-sheets-as-extraction.md): Import Google Sheets data as an extraction for processing.
- [Verify Sheet Access](https://docs.bavlio.com/api-reference/google-sheets-oauth/verify-sheet-access.md): Verify user has access to a Google Sheet.
- [Health Check](https://docs.bavlio.com/api-reference/health/health-check.md): Basic health check endpoint.
- [Readiness Check](https://docs.bavlio.com/api-reference/health/readiness-check.md): Readiness check endpoint for container orchestration.
- [System Status](https://docs.bavlio.com/api-reference/health/system-status.md): Comprehensive system status check.
- [API Reference](https://docs.bavlio.com/api-reference/introduction.md): Full OpenAPI 3.1 specification for the Bavlio API. 190+ endpoints across campaigns, leads, sender profiles, personalization, BaviMail proxy, and more.
- [Get Batch Status](https://docs.bavlio.com/api-reference/lead-finder/get-batch-status.md): Poll batch lead finder progress. Ownership-guarded (L4).
- [Submit Batch](https://docs.bavlio.com/api-reference/lead-finder/submit-batch.md): Submit a batch of names to find LinkedIn URLs.
- [Cancel Post](https://docs.bavlio.com/api-reference/linkedin-content/cancel-post.md)
- [Create Post](https://docs.bavlio.com/api-reference/linkedin-content/create-post.md)
- [Get Rate Limit](https://docs.bavlio.com/api-reference/linkedin-content/get-rate-limit.md)
- [List Posts](https://docs.bavlio.com/api-reference/linkedin-content/list-posts.md)
- [Schedule Post](https://docs.bavlio.com/api-reference/linkedin-content/schedule-post.md)
- [Sync Posts](https://docs.bavlio.com/api-reference/linkedin-content/sync-posts.md)
- [Get Profile](https://docs.bavlio.com/api-reference/linkedin-playground/get-profile.md)
- [List Actions](https://docs.bavlio.com/api-reference/linkedin-playground/list-actions.md): Return persistent action history and today's usage counts.
- [List Chat Messages](https://docs.bavlio.com/api-reference/linkedin-playground/list-chat-messages.md)
- [List Chats](https://docs.bavlio.com/api-reference/linkedin-playground/list-chats.md)
- [Save Search Results](https://docs.bavlio.com/api-reference/linkedin-playground/save-search-results.md): Save LinkedIn search results as a lead dataset.
- [Search Linkedin](https://docs.bavlio.com/api-reference/linkedin-playground/search-linkedin.md)
- [Send Invite](https://docs.bavlio.com/api-reference/linkedin-playground/send-invite.md)
- [Send Message](https://docs.bavlio.com/api-reference/linkedin-playground/send-message.md)
- [Get Alerts](https://docs.bavlio.com/api-reference/notifications/get-alerts.md): Get user alerts. Default: unread only.
- [Get Preferences](https://docs.bavlio.com/api-reference/notifications/get-preferences.md): Get notification preferences for the current user.
- [Mark Alert Read](https://docs.bavlio.com/api-reference/notifications/mark-alert-read.md): Mark an alert as read.
- [Send Test Notification](https://docs.bavlio.com/api-reference/notifications/send-test-notification.md): Send a test notification to verify delivery.
- [Update Preferences](https://docs.bavlio.com/api-reference/notifications/update-preferences.md): Upsert notification preferences for the current user.
- [Batch preview (SSE) — up to 25 leads, streams results as they complete](https://docs.bavlio.com/api-reference/personalization/batch-preview-sse-—-up-to-25-leads-streams-results-as-they-complete.md): Serial backend processing (no gather) to keep per-lead cache behavior predictable and budget-flat. Streams one SSE `lead_result` event per lead and a final `done` event. Echoes `client_run_id` as `batch_id` on every event so frontends can discard stale events from prior runs.
- [Check personalization job status](https://docs.bavlio.com/api-reference/personalization/check-personalization-job-status.md): Get comprehensive status information for a personalization job
- [Fetch the default personalization prompt](https://docs.bavlio.com/api-reference/personalization/fetch-the-default-personalization-prompt.md): Returns the current default system prompt for email generation so the UI can show it as a starting point for user edits.
- [Get a single run + its first 500 per-lead generations](https://docs.bavlio.com/api-reference/personalization/get-a-single-run-+-its-first-500-per-lead-generations.md)
- [Get personalization job result](https://docs.bavlio.com/api-reference/personalization/get-personalization-job-result.md): Retrieve the result of a completed personalization job
- [List recent generation runs for a given prompt](https://docs.bavlio.com/api-reference/personalization/list-recent-generation-runs-for-a-given-prompt.md)
- [List user's datasets for the inline data-source picker](https://docs.bavlio.com/api-reference/personalization/list-users-datasets-for-the-inline-data-source-picker.md)
- [Paginated leads list for a single run (for >500-lead runs)](https://docs.bavlio.com/api-reference/personalization/paginated-leads-list-for-a-single-run-for->500-lead-runs.md)
- [Queue bulk personalization requests](https://docs.bavlio.com/api-reference/personalization/queue-bulk-personalization-requests.md): Queue multiple lead-sender pairs for background personalization with enhanced validation
- [Queue personalization request](https://docs.bavlio.com/api-reference/personalization/queue-personalization-request.md): Queue a personalization request for background processing with enhanced validation and monitoring
- [Resolve the prompt the playground should boot into](https://docs.bavlio.com/api-reference/personalization/resolve-the-prompt-the-playground-should-boot-into.md): Runs resolve_effective_prompt server-side with default_load_mode=True, returning the user's most-recently-saved named prompt if one exists, else the transitional custom_prompt, else the stock default. Single source of truth for playground boot (plan §4.7).
- [Save a custom prompt onto a sender profile](https://docs.bavlio.com/api-reference/personalization/save-a-custom-prompt-onto-a-sender-profile.md): Upserts the given prompt into `sender_data.prompts[]` (named slot, default 'saved') AND mirrors it to `sender_data.custom_prompt` atomically. Used from the preview playground when a user wants future campaigns to use their iterated prompt.
- [Sync preview of a personalized email for a single lead](https://docs.bavlio.com/api-reference/personalization/sync-preview-of-a-personalized-email-for-a-single-lead.md): Blocking endpoint. Runs find_commonalities + generate_email inline against the provided lead + sender profile. Returns subject, body, commonality, and the prompt source used. Does not create a campaign, does not queue a job.
- [Approve Lead Email](https://docs.bavlio.com/api-reference/playground/approve-lead-email.md): Freeze a per-step approved email on this campaign_lead.
- [Playground Cancel](https://docs.bavlio.com/api-reference/playground/playground-cancel.md): DB-authoritative cancel — flip generation_job.status to 'cancelled'.
- [Playground Drafts](https://docs.bavlio.com/api-reference/playground/playground-drafts.md): Return full draft subject+body for every lead in the batch.
- [Playground Generate](https://docs.bavlio.com/api-reference/playground/playground-generate.md): Enqueue an ARQ ``playground_generation`` task per target lead.
- [Playground Status](https://docs.bavlio.com/api-reference/playground/playground-status.md): Aggregate generation_job state per lead for the optional batch_id.
- [Reset Lead Approvals](https://docs.bavlio.com/api-reference/playground/reset-lead-approvals.md): Reset approvals for this lead. Omitting step_indices clears every step.
- [Unapprove Lead Email](https://docs.bavlio.com/api-reference/playground/unapprove-lead-email.md): Clear the approved blob for one step on this lead.
- [Apply Referral Code](https://docs.bavlio.com/api-reference/referral/apply-referral-code.md): Apply a referral code to the current user.
- [Get Referral Code](https://docs.bavlio.com/api-reference/referral/get-referral-code.md): Get or generate the user's referral code.
- [Get Referral Stats](https://docs.bavlio.com/api-reference/referral/get-referral-stats.md): Get referral statistics for the current user.
- [Root Health Check](https://docs.bavlio.com/api-reference/root-health-check.md): Simple health check endpoint for Docker.
- [Cancel Chat Session](https://docs.bavlio.com/api-reference/sender-profile-chat/cancel-chat-session.md): Cancel a chat session.
- [Get Chat History](https://docs.bavlio.com/api-reference/sender-profile-chat/get-chat-history.md): Get the chat history for a session.
- [Send Chat Message](https://docs.bavlio.com/api-reference/sender-profile-chat/send-chat-message.md): Send a message in the chat session.
- [Start Chat Session](https://docs.bavlio.com/api-reference/sender-profile-chat/start-chat-session.md): Start a new chat session for creating a sender profile.
- [Create Named Prompt](https://docs.bavlio.com/api-reference/sender-profiles/create-named-prompt.md)
- [Create Sender Profile](https://docs.bavlio.com/api-reference/sender-profiles/create-sender-profile.md): Create a new sender profile.
- [Delete Named Prompt](https://docs.bavlio.com/api-reference/sender-profiles/delete-named-prompt.md)
- [Delete Sender Profile](https://docs.bavlio.com/api-reference/sender-profiles/delete-sender-profile.md): Delete a sender profile.
- [Get Default Sender Profile](https://docs.bavlio.com/api-reference/sender-profiles/get-default-sender-profile.md): Get the default sender profile for the authenticated user.
- [Get Sender Profile](https://docs.bavlio.com/api-reference/sender-profiles/get-sender-profile.md): Retrieve a specific sender profile.
- [List Named Prompts](https://docs.bavlio.com/api-reference/sender-profiles/list-named-prompts.md)
- [List Sender Profiles](https://docs.bavlio.com/api-reference/sender-profiles/list-sender-profiles.md): List all sender profiles for the authenticated user.
- [Search Sender Profiles](https://docs.bavlio.com/api-reference/sender-profiles/search-sender-profiles.md): Search sender profiles by name.
- [Update Named Prompt](https://docs.bavlio.com/api-reference/sender-profiles/update-named-prompt.md)
- [Update Sender Profile](https://docs.bavlio.com/api-reference/sender-profiles/update-sender-profile.md): Update an existing sender profile.
- [Add leads to session](https://docs.bavlio.com/api-reference/session-management/add-leads-to-session.md): Queue leads for processing in an existing session
- [Bulk update sender data](https://docs.bavlio.com/api-reference/session-management/bulk-update-sender-data.md): Update sender data from multiple sources (JSON objects)
- [Create processing session](https://docs.bavlio.com/api-reference/session-management/create-processing-session.md): Create a new processing session with initial sender data
- [Create session from existing dataset](https://docs.bavlio.com/api-reference/session-management/create-session-from-existing-dataset.md): Create a new session linked to an existing dataset for re-enrichment
- [Delete session](https://docs.bavlio.com/api-reference/session-management/delete-session.md): Clean up session data and remove all associated resources
- [Get job status](https://docs.bavlio.com/api-reference/session-management/get-job-status.md): Check the status of a background job associated with a session
- [Get session results](https://docs.bavlio.com/api-reference/session-management/get-session-results.md): Retrieve processing results for a completed or in-progress session
- [Get session status](https://docs.bavlio.com/api-reference/session-management/get-session-status.md): Retrieve current status and progress information for a session
- [Update sender data](https://docs.bavlio.com/api-reference/session-management/update-sender-data.md): Add or update sender data for an existing session
- [Start session processing](https://docs.bavlio.com/api-reference/session-processing/start-session-processing.md): Start background processing of all queued leads in a session
- [Create Checkout Session](https://docs.bavlio.com/api-reference/stripe/create-checkout-session.md): Create a Stripe Checkout session for the requested tier.
- [Create Portal Session](https://docs.bavlio.com/api-reference/stripe/create-portal-session.md): Create a Stripe Billing Portal session for subscription management.
- [Get Subscription Status](https://docs.bavlio.com/api-reference/stripe/get-subscription-status.md): Return current subscription info for the authenticated user.
- [Purchase Credits](https://docs.bavlio.com/api-reference/stripe/purchase-credits.md): Create a Stripe Checkout session for a one-time credit top-up purchase.
- [Add Suppression](https://docs.bavlio.com/api-reference/suppression/add-suppression.md): Add an email to the suppression list.
- [Delete Suppression](https://docs.bavlio.com/api-reference/suppression/delete-suppression.md): Remove an email from the suppression list.
- [List Suppression](https://docs.bavlio.com/api-reference/suppression/list-suppression.md): List suppression entries for the current user.
- [Create Template](https://docs.bavlio.com/api-reference/templates/create-template.md): Create a new email template.
- [Delete Template](https://docs.bavlio.com/api-reference/templates/delete-template.md): Delete a template.
- [Get Template](https://docs.bavlio.com/api-reference/templates/get-template.md): Get a specific template by ID.
- [List Templates](https://docs.bavlio.com/api-reference/templates/list-templates.md): List all templates for the authenticated user.
- [Update Template](https://docs.bavlio.com/api-reference/templates/update-template.md): Update a template.
- [Bulk Delete Extractions](https://docs.bavlio.com/api-reference/user-extractions/bulk-delete-extractions.md): Delete multiple extractions in bulk.
- [Create Session From Extraction](https://docs.bavlio.com/api-reference/user-extractions/create-session-from-extraction.md): Create an enrichment session from a saved extraction.
- [Delete Extraction](https://docs.bavlio.com/api-reference/user-extractions/delete-extraction.md): Delete a single extraction.
- [Download Extraction](https://docs.bavlio.com/api-reference/user-extractions/download-extraction.md): Download an extraction in the specified format.
- [Get Extraction Info](https://docs.bavlio.com/api-reference/user-extractions/get-extraction-info.md): Get detailed information about a specific extraction.
- [List User Extractions](https://docs.bavlio.com/api-reference/user-extractions/list-user-extractions.md): List all available extractions for the authenticated user.
- [Process Extraction To Session](https://docs.bavlio.com/api-reference/user-extractions/process-extraction-to-session.md): Process an extraction into a session for lead personalization.
- [Rename Extraction](https://docs.bavlio.com/api-reference/user-extractions/rename-extraction.md): Rename an extraction (update its title in metadata).
- [Rename Extraction Options](https://docs.bavlio.com/api-reference/user-extractions/rename-extraction-options.md): Handle CORS preflight for rename endpoint.
- [Get Quota Status](https://docs.bavlio.com/api-reference/users/get-quota-status.md): Get detailed quota status and recommendations.
- [Get Usage Dashboard](https://docs.bavlio.com/api-reference/users/get-usage-dashboard.md): Get user's current usage statistics and quota information.
- [Handle Unipile Webhook](https://docs.bavlio.com/api-reference/webhooks/handle-unipile-webhook.md): Receive and process Unipile webhook events.
- [Health Check](https://docs.bavlio.com/api-reference/webhooks/health-check.md)
- [Stripe Webhook](https://docs.bavlio.com/api-reference/webhooks/stripe-webhook.md): Stripe webhook endpoint — signature-verified, idempotent via event dedup.
- [Webhook Handler](https://docs.bavlio.com/api-reference/webhooks/webhook-handler.md)
- [DNS-only email deliverability check (x402-paid, $0.003 USDC)](https://docs.bavlio.com/api-reference/x402/dns-only-email-deliverability-check-x402-paid-$0003-usdc.md): DNS-only inline validate. No ARQ. No user context. Idempotent.
- [Find LinkedIn profile URL via public search engines (x402-paid, $0.008 USDC)](https://docs.bavlio.com/api-reference/x402/find-linkedin-profile-url-via-public-search-engines-x402-paid-$0008-usdc.md): SYNC inline search. No ARQ. No user context. Idempotent per query.
- [Find working email via sequential SMTP pattern probing (x402-paid, $0.010 USDC)](https://docs.bavlio.com/api-reference/x402/find-working-email-via-sequential-smtp-pattern-probing-x402-paid-$0010-usdc.md): SYNC inline SMTP find. No ARQ. No user context. Idempotent per candidate list.
- [Search prospect pool by tag overlap (x402-paid, $0.012 USDC)](https://docs.bavlio.com/api-reference/x402/search-prospect-pool-by-tag-overlap-x402-paid-$0012-usdc.md): SYNC inline Supabase read. No ARQ. No user context. Idempotent.
- [Verify deliverability via SMTP RCPT probe (x402-paid, $0.005 USDC)](https://docs.bavlio.com/api-reference/x402/verify-deliverability-via-smtp-rcpt-probe-x402-paid-$0005-usdc.md): SYNC inline SMTP verify. No ARQ. No user context. Idempotent.
- [Authentication](https://docs.bavlio.com/authentication.md): bav_live_ API keys, Bearer tokens, key rotation, x402 wallet auth as alternative.
- [Errors & Idempotency](https://docs.bavlio.com/errors.md): Three error envelopes coexist today. Status code reference, retry rules, and current idempotency state with workaround.
- [MCP (Model Context Protocol)](https://docs.bavlio.com/integrations/mcp.md): Two MCP surfaces — a docs MCP server live today (queries the documentation), and a planned API-action MCP server (drives the live API).
- [Bavlio API](https://docs.bavlio.com/introduction.md): Agent-first sales outreach infrastructure. Authenticate with one API key, invoke any capability, no human-in-the-loop required.
- [Pagination](https://docs.bavlio.com/pagination.md): Bavlio's pagination is endpoint-specific — three patterns coexist. The OpenAPI spec is the source of truth for any endpoint's request and response shape.
- [Quickstart](https://docs.bavlio.com/quickstart.md): Authenticate, make your first call, handle errors, paginate, and retry safely. Five minutes from key to first response.
- [Rate Limits](https://docs.bavlio.com/rate-limits.md): Bavlio sets X-RateLimit-Limit and X-RateLimit-Reset headers on API-key authenticated requests. How to read them and how to back off correctly.
- [Webhooks](https://docs.bavlio.com/webhooks.md): Customer-registered webhooks are not yet available. Use polling endpoints for campaign state, replies, and email events.

## OpenAPI Specs

- [openapi](https://docs.bavlio.com/api-reference/openapi.json)