# Victoria AI Docs

> Documentation for Victoria AI, an outbound AI SDR that runs LinkedIn and email sequences from your own accounts. The Help Center covers using the app, the Playbook covers outbound practice with example sequences, and the API reference and guides cover the REST API (leads, campaigns and sequences, analytics, CRM pipelines and deals, reply webhooks) and the MCP server.

- Base URL: `https://api.versionseven.ai/v1`. Requests and responses are JSON.
- Authentication: send `Authorization: Bearer <key>` on every request. Keys start with `vk_`, are generated in the Victoria AI app under Settings → API Keys, and each belongs to one organization.
- Errors share one body, `{"success": false, "error": "CODE", "message": "…", "details": {…}, "request_id": "…"}`. Branch on `error`; `details` is only present for some errors.
- List endpoints page with `limit` and `offset` and return `count`, `total`, `limit`, `offset` and `has_more`.
- Rate limits: 100 requests a minute to each endpoint and 600 a minute in total, per API key. Going over answers `429 RATE_LIMITED` with a `Retry-After` header.
- Create requests (`POST /v1/leads`, `POST /v1/campaigns`, `POST /v1/crm/deals`) accept an `Idempotency-Key` header, which makes retries safe.
- Webhooks: the `prospect_response` event is sent to a campaign's webhooks when a prospect replies. Deliveries from a webhook with a secret carry `X-Signature-256: sha256=<hex HMAC-SHA256 of the raw body>`. Deduplicate on the payload's `idempotency_key`.
- The OpenAPI specification is served at `https://api.versionseven.ai/openapi.json`.
- MCP server: `https://api.versionseven.ai/mcp`. To connect Claude (claude.ai, the desktop app or Cowork): Settings → Connectors → Add custom connector, paste the URL, then sign in to Victoria AI, choose Read and write (builds and launches campaigns, confirming each change) or Read only, and choose Allow. To connect ChatGPT: Settings → Connectors → Create (developer mode on), same URL, same sign-in. No API key is involved. Claude Code: `claude mcp add --transport http victoria https://api.versionseven.ai/mcp` then `/mcp` to sign in. Cursor and scripts send an API key as the bearer header. Guide: `https://docs.versionseven.ai/guides/connect-your-ai`.
- Using the Victoria AI app (senders, leads, campaigns, the Appointment Setter, billing, troubleshooting) is covered by the Help Center at `https://docs.versionseven.ai/help`; outbound practice and example sequences by the Playbook at `https://docs.versionseven.ai/playbook`. Both are listed below.
- Product, pricing and feature descriptions live on the marketing site: `https://www.versionseven.ai/llms.txt` is the index and `https://www.versionseven.ai/llms-full.txt` the full text. Any page there has a Markdown export at its URL with `.md` added.
- Victoria Pulse has a separate API and MCP server: its OpenAPI document is at `https://data.versionseven.ai/openapi.json` and its MCP endpoint at `https://data.versionseven.ai/mcp`.

## Guides

- [Quickstart](https://docs.versionseven.ai/guides/quickstart.md): Create an API key, verify it, and add your first lead to a campaign with the Victoria AI REST API.
- [Authentication](https://docs.versionseven.ai/guides/authentication.md): Create and use API keys, understand the organization and scopes a key covers, and handle authentication errors.
- [Connect your AI](https://docs.versionseven.ai/guides/connect-your-ai.md): Connect Claude, ChatGPT, Claude Code or any MCP host to your Victoria AI workspace, and what a connected assistant can and can't do.
- [Set up a campaign by API](https://docs.versionseven.ai/guides/set-up-a-campaign.md): Create a campaign, write its sequence, add AI fields and senders, check the activation preflight, and activate it, all from the REST API.
- [AI Personalization fields](https://docs.versionseven.ai/guides/ai-personalization-fields.md): What an AI Personalization field is, how Victoria AI fills it for each lead, what happens when the research finds nothing, and the endpoints that manage fields.
- [AI Appointment Setter](https://docs.versionseven.ai/guides/ai-appointment-setter.md): How the AI Appointment Setter handles a reply, when it hands off to a person, and how integrations configure it and hear about replies.
- [Simple CRM](https://docs.versionseven.ai/guides/crm.md): The pipelines and deals in Victoria AI's Simple CRM, what a deal links to, what happens on a booked meeting, and the CRM endpoints.
- [Lead database](https://docs.versionseven.ai/guides/lead-database.md): What the in-app Lead database searches, how emails are verified, what a search costs, and which parts are available over MCP and REST.
- [Credits](https://docs.versionseven.ai/guides/credits.md): What spends credits in Victoria AI, how balances roll over, and how an API or MCP integration finds out that the balance has run out.
- [Errors](https://docs.versionseven.ai/guides/errors.md): The error response body, what each HTTP status means, how to read validation errors, and every error code the API returns.
- [Pagination](https://docs.versionseven.ai/guides/pagination.md): Page through list endpoints with limit and offset, and use has_more to tell when you've reached the last page.
- [Rate limits](https://docs.versionseven.ai/guides/rate-limits.md): The per-endpoint and overall request limits on the Victoria AI API, the headers that report them, and how to handle a 429.
- [Idempotency](https://docs.versionseven.ai/guides/idempotency.md): Send an Idempotency-Key header so a retried create request returns the original result instead of doing the work twice.
- [Versioning and deprecation](https://docs.versionseven.ai/guides/versioning.md): How the Victoria AI API is versioned, how deprecated endpoints are announced, and where to get the OpenAPI specification.
- [Receiving webhooks](https://docs.versionseven.ai/guides/webhooks.md): Register a webhook on a campaign to hear when a prospect replies, and handle deliveries, retries and duplicates.
- [Verifying webhook signatures](https://docs.versionseven.ai/guides/verifying-webhooks.md): Check the X-Signature-256 header on each webhook delivery so your endpoint only acts on requests that came from Victoria AI.

## Help Center

- [Help Center](https://docs.versionseven.ai/help.md): How to use the Victoria AI app: senders, leads, campaigns, the Appointment Setter, billing and troubleshooting.
- [What is Victoria AI](https://docs.versionseven.ai/help/what-is-victoria.md): What Victoria AI does, what each part of the app is for, and the order most teams set it up in.
- [How the free trial works](https://docs.versionseven.ai/help/free-trial.md): What the Victoria AI free trial includes, what ends it early, and when your card is charged or not.
- [Set up Victoria AI with the Copilot](https://docs.versionseven.ai/help/set-up-with-the-copilot.md): How the guided setup conversation works, how to skip it, and how to pick it up again from the dashboard.
- [Setup credits](https://docs.versionseven.ai/help/setup-credits.md): The bonus credits each setup milestone earns, when each one lands, and the rules that apply to them.
- [Your first month with Victoria AI](https://docs.versionseven.ai/help/first-month.md): A week-by-week routine for your first month with Victoria AI, from setup and daily replies to weekly analytics, A/B decisions and lead refills.
- [Victoria AI glossary](https://docs.versionseven.ai/help/glossary.md): Plain definitions of the terms used across Victoria AI, from backlog and runway to seats, ramps and preflight.
- [Connect a LinkedIn account](https://docs.versionseven.ai/help/connect-linkedin.md): Connect your LinkedIn account as a sender in Victoria AI, what happens after it connects, and what to do if it fails.
- [Connect a Gmail or Outlook mailbox](https://docs.versionseven.ai/help/connect-gmail-or-outlook.md): Connect a Google Workspace or Microsoft 365 mailbox as an email sender, and what the DNS check does once it connects.
- [Connect a sender with an invite link](https://docs.versionseven.ai/help/connect-a-sender-with-an-invite-link.md): Send a colleague or client a link that connects their LinkedIn or email account to your workspace without sharing a password.
- [Reconnect a disconnected sender](https://docs.versionseven.ai/help/reconnect-a-sender.md): Why a LinkedIn or email sender disconnects, what stops while it's disconnected, and how to reconnect it from Sender Accounts.
- [LinkedIn limits, ramp and restrictions](https://docs.versionseven.ai/help/linkedin-restrictions-and-limits.md): The daily and weekly caps on each LinkedIn sender, the warm-up ramp, and what happens after LinkedIn restricts an account.
- [Sending mailbox best practices](https://docs.versionseven.ai/help/sending-mailbox-best-practices.md): Set up mailboxes for Victoria AI cold email the safe way, on a dedicated sending domain, warmed up and with SPF, DKIM and DMARC in place.
- [Email sending limits and the warm-up ramp](https://docs.versionseven.ai/help/sender-limits-and-ramp.md): How many emails each mailbox and campaign can send, how the warm-up ramp works, and why Victoria has no separate warm-up service.
- [Set up SPF, DKIM and DMARC for your sending domain](https://docs.versionseven.ai/help/dns-setup.md): What SPF, DKIM and DMARC do, how to read the DNS check on Sender Accounts, and how to add the records for Google or Microsoft.
- [Remove or replace a sender](https://docs.versionseven.ai/help/remove-or-replace-a-sender.md): What removing a LinkedIn or email sender pauses and stops, who can remove one, and how to swap in a different account.
- [Find leads in the Lead database](https://docs.versionseven.ai/help/find-leads-in-the-lead-database.md): Search the Lead database from a campaign, preview results, and add leads with emails or LinkedIn only, with what each step costs.
- [Import leads from a CSV](https://docs.versionseven.ai/help/import-a-csv.md): Upload a CSV or XLSX of leads into a campaign, map its columns, and turn extra columns into variables for your sequence.
- [Do Not Contact list](https://docs.versionseven.ai/help/do-not-contact.md): Block emails, domains and LinkedIn profiles from every campaign, what the list blocks, and how opt-outs are added automatically.
- [Trial lead cap](https://docs.versionseven.ai/help/trial-lead-cap.md): How many leads a trial workspace can hold, what counts toward the cap, and what to do when an import is refused.
- [Build a campaign](https://docs.versionseven.ai/help/build-a-campaign.md): Create a campaign in Victoria AI from start to activation, in the app or with the AI Sales Copilot.
- [Sequence steps and branches](https://docs.versionseven.ai/help/sequence-steps-and-branches.md): Every step type in a Victoria AI sequence, how delays work, and how the connection-accepted branch splits leads.
- [Personalization fields and variables](https://docs.versionseven.ai/help/personalization-fields.md): Lead variables, custom fields and AI Personalization fields in Victoria AI messages, with fallbacks, coverage, held leads and costs.
- [A/B test a sequence](https://docs.versionseven.ai/help/ab-testing.md): Run two variations of a Victoria AI sequence, split new leads between them, read the verdict, and end the test.
- [Work hours and daily limits](https://docs.versionseven.ai/help/work-hours-and-daily-limits.md): Set when a Victoria AI campaign sends and how much it sends each day, and how campaign limits combine with sender limits.
- [Preflight checks](https://docs.versionseven.ai/help/preflight-checks.md): Every readiness check Victoria AI runs before a campaign activates, what each message means, and how to fix it.
- [Edit a live campaign](https://docs.versionseven.ai/help/edit-a-live-campaign.md): Which changes are safe while a Victoria AI campaign has leads in progress, and why adding or deleting steps can shift leads.
- [Pause, duplicate or archive a campaign](https://docs.versionseven.ai/help/pause-duplicate-archive.md): Stop a Victoria AI campaign for now, copy it as a starting point, or archive it for good, and what each one keeps.
- [Inbox basics](https://docs.versionseven.ai/help/inbox-basics.md): Read and answer replies in the Victoria AI Inbox, filter conversations, close and reopen them, and see the whole team's threads.
- [Appointment Setter](https://docs.versionseven.ai/help/appointment-setter.md): Set up the AI Appointment Setter on a Victoria AI campaign, choose its mode and goal, and take over or hand back conversations.
- [Replies and sentiment](https://docs.versionseven.ai/help/replies-and-sentiment.md): How Victoria AI labels each reply, what happens to a lead who replies or opts out, and how to correct the record.
- [Analytics metrics](https://docs.versionseven.ai/help/analytics-metrics.md): What every number on the Victoria AI Dashboard and campaign Analytics tab counts, its unit, and how date ranges and filters apply.
- [Campaign health indicators](https://docs.versionseven.ai/help/campaign-health.md): What the warning icons and banners on a Victoria AI campaign mean, and how to clear them.
- [Connect your AI assistant](https://docs.versionseven.ai/help/connect-your-ai-assistant.md): Connect Claude or ChatGPT to your Victoria AI workspace in three steps, and choose read-only or read-and-write access.
- [Plans and add-ons](https://docs.versionseven.ai/help/plans-and-add-ons.md): What the Workspace and Agency plans include, how to add LinkedIn seats and mailboxes, and how removing an add-on works.
- [Credits and rollover](https://docs.versionseven.ai/help/credits-and-rollover.md): What spends credits in Victoria AI, what is free, how the monthly grant rolls over, and what stops when the balance reaches zero.
- [Buy credits and set up auto-recharge](https://docs.versionseven.ai/help/buy-credits-and-auto-recharge.md): Buy a credit pack from Credits & Billing, set auto-recharge to top up when your balance runs low, and fix a purchase that didn't land.
- [Failed payments](https://docs.versionseven.ai/help/failed-payments.md): What pauses when a subscription payment fails, how long your senders are kept, and how to update your card to resume.
- [Cancel or reactivate your subscription](https://docs.versionseven.ai/help/cancel-or-reactivate.md): How canceling works for a trial and a paid plan, what happens to your senders and credits, and how to reactivate.
- [Plans, limits and credits at a glance](https://docs.versionseven.ai/help/facts.md): Every plan price, credit cost, trial limit, sending cap and setting bound in Victoria AI, on one page.
- [Invite teammates and manage roles](https://docs.versionseven.ai/help/invite-teammates-and-roles.md): Invite people to your Victoria AI workspace, what the owner, admin and member roles can each do, and how to change or remove someone.
- [Create and manage API keys](https://docs.versionseven.ai/help/api-keys.md): Generate an API key with the access it needs and an expiry, use it with the REST API or MCP, and revoke it when you're done.
- [Notifications and alert emails](https://docs.versionseven.ai/help/notifications.md): Where Victoria AI notifications appear, what they alert you to, who gets the matching emails, and how to clear them.
- [Campaign won't activate](https://docs.versionseven.ai/help/troubleshooting-campaign-wont-activate.md): Why the Activate Campaign button stays disabled in Victoria AI, and how to clear each kind of blocker.
- [Leads aren't moving](https://docs.versionseven.ai/help/troubleshooting-leads-not-moving.md): Why leads in an active Victoria AI campaign aren't getting their next step, and the fix for each cause.
- [Campaign gets no replies](https://docs.versionseven.ai/help/troubleshooting-no-replies.md): Diagnose a Victoria AI campaign that sends but gets few or no replies, from deliverability to copy and targeting.
- [Sender disconnected](https://docs.versionseven.ai/help/troubleshooting-sender-disconnected.md): What happens to a Victoria AI campaign when a LinkedIn or email sender disconnects, and how to get it sending again.

## Playbook

- [Playbook](https://docs.versionseven.ai/playbook.md): How to run outbound with Victoria AI: targeting, messaging, replies, and example sequences you can copy.
- [Optimize your LinkedIn profile before you send](https://docs.versionseven.ai/playbook/linkedin-profile.md): The headshot and headline that get your Victoria AI connection requests accepted, and why your profile matters more than any message.
- [Give before you ask](https://docs.versionseven.ai/playbook/give-before-you-ask.md): Why cold outreach that gives value first beats asking, ideas for what to give, and how to give without sending content nobody asked for.
- [Calls to action in cold outreach](https://docs.versionseven.ai/playbook/ctas.md): How to end a cold message in a Victoria AI sequence so it's easy to answer, starting with give-first CTAs and changing from first touch to last.
- [Framing your value proposition](https://docs.versionseven.ai/playbook/value-proposition.md): How to state your offer in Victoria AI outreach as "I help X do Y by Z": a specific buyer, a niche outcome and a short differentiator.
- [Who to target and on which channel](https://docs.versionseven.ai/playbook/targeting-and-channels.md): Which buyers respond on LinkedIn and which on email, and how to reach 1 to 3 decision makers at the same company without tripping over yourself.
- [Openers that get replies](https://docs.versionseven.ai/playbook/openers.md): Two opener structures for cold LinkedIn messages and emails in Victoria AI: "I help X do Y by Z" and the question opener, each with a give-first CTA.
- [Cold email principles](https://docs.versionseven.ai/playbook/cold-email-principles.md): How to write cold emails in Victoria AI that get read and answered: short, about the prospect, giving before asking, one small CTA.
- [LinkedIn connection requests](https://docs.versionseven.ai/playbook/linkedin-connection-requests.md): Why Victoria AI connection requests go out blank by default, how much that lifts acceptance, and what a note should say if you add one.
- [LinkedIn messages after connecting](https://docs.versionseven.ai/playbook/linkedin-messages-after-connect.md): What to send on LinkedIn after a prospect accepts your Victoria AI connection request, message by message, using a give-first opener.
- [Slop: words and habits that kill replies](https://docs.versionseven.ai/playbook/slop-language.md): The AI tells, played-out phrases and ask-ask-ask habits that make cold outreach read as spam, and what to write instead of each.
- [Personalization that works](https://docs.versionseven.ai/playbook/personalization-instructions.md): The personalization that gets replies, in order: buying signals, offer-relevant company and role details, then personal details, with AI field instructions.
- [Message formatting](https://docs.versionseven.ai/playbook/message-formatting.md): How to lay out emails and LinkedIn messages in a Victoria AI sequence so they're easy to read on a phone.
- [Step delays](https://docs.versionseven.ai/playbook/step-delays.md): How to space the steps of a Victoria AI sequence, from the connection acceptance window to backing off between messages.
- [Choosing a sequence shape](https://docs.versionseven.ai/playbook/choosing-a-sequence-shape.md): The three sequence shapes we recommend in Victoria AI, LinkedIn only, email only and Email + LinkedIn, and which buyers and lead data each one suits.
- [Size a campaign to your sending capacity](https://docs.versionseven.ai/playbook/size-a-campaign.md): How many leads to load into a Victoria AI campaign, based on your senders and daily limits, with room for an A/B test and a refill rhythm.
- [Configuring the Appointment Setter](https://docs.versionseven.ai/playbook/appointment-setter-configuration.md): How to set up and test the Victoria AI Appointment Setter so it works every reply toward your goal and hands the right conversations to you.
- [Appointment Setter knowledge and assets](https://docs.versionseven.ai/playbook/setter-knowledge-documents.md): What to put in the Victoria AI Appointment Setter's campaign description, knowledge base and assets so its answers are accurate.
- [After a positive reply](https://docs.versionseven.ai/playbook/after-a-positive-reply.md): What to send once a prospect replies with interest in Victoria AI, give first and then ask for the meeting, framed as a valuable next step.
- [Objections and hard no's](https://docs.versionseven.ai/playbook/objections-and-hard-nos.md): How to answer a hard no with a friendly break-up, handle common objections in Victoria AI replies, and when a pricing question should become a call.
- [Outbound benchmarks](https://docs.versionseven.ai/playbook/benchmarks.md): Typical cold outreach rates and the healthier targets to aim for with Victoria AI, mapped to its metrics, and how much data you need before judging.
- [Diagnose a campaign by its bottleneck](https://docs.versionseven.ai/playbook/diagnose-a-campaign.md): A step-by-step checklist for finding why a Victoria AI campaign underperforms, starting at the first weak stage of the funnel and fixing that first.
- [Starter sequence: multichannel B2B](https://docs.versionseven.ai/playbook/sequences/multichannel-b2b-default.md): Our recommended Email + LinkedIn sequence in Victoria AI, a blank request with a 10-day window, then two branches that reference each other.
- [Starter sequence: LinkedIn-only, give first](https://docs.versionseven.ai/playbook/sequences/linkedin-only-give-first.md): Our recommended LinkedIn-only sequence in Victoria AI, a blank connection request then three give-first messages, with full copy and timing.
- [Starter sequence: email-only, give first](https://docs.versionseven.ai/playbook/sequences/email-only-give-first.md): Our recommended five-email sequence in Victoria AI, spaced 2, 3, 5 and 5 days apart, where every email gives something, with full copy.

## API reference

- [API Reference](https://docs.versionseven.ai/api-reference.md): Every endpoint of the API grouped by resource, with the base URL and webhook events.
- [Auth](https://docs.versionseven.ai/api-reference/auth.md): Check that an API key works and see which organization it belongs to.
- [Sender accounts](https://docs.versionseven.ai/api-reference/accounts.md): The LinkedIn and email accounts connected to your organization for outreach, whether each one is still connected, and links that connect or reconnect one.
- [Leads](https://docs.versionseven.ai/api-reference/leads.md): Create leads, enrol them in campaigns, find them with filters, update them, and remove them from campaigns.
- [Campaigns](https://docs.versionseven.ai/api-reference/campaigns.md): Create and manage campaigns: their sequences, AI fields, senders, reply agent, activation preflight, analytics, A/B tests, bookings, lead queue, and the webhooks that receive prospect replies.
- [Pipelines](https://docs.versionseven.ai/api-reference/crm-pipelines.md): Read and update the CRM pipelines that deals move through, along with their stages.
- [Deals](https://docs.versionseven.ai/api-reference/crm-deals.md): Create, list, retrieve and update deals in the Victoria AI CRM.
- [Reference](https://docs.versionseven.ai/api-reference/reference.md): Blank sequence templates to start from, and example payloads for building a webhook receiver.

## Endpoints: Auth

- [Verify an API key](https://docs.versionseven.ai/api-reference/auth/verify-api-key.md): `GET /v1/auth/verify`. Verify API key and return organization details.

## Endpoints: Sender accounts

- [List sender accounts](https://docs.versionseven.ai/api-reference/accounts/list-accounts.md): `GET /v1/accounts`. List connected sender accounts.
- [Create a connect link](https://docs.versionseven.ai/api-reference/accounts/create-connect-link.md): `POST /v1/accounts/connect-link`. Mint a hosted sign-in link that connects a LinkedIn or email sender account to your organization, or reconnects one that disconnected.

## Endpoints: Leads

- [Create a lead](https://docs.versionseven.ai/api-reference/leads/create-lead.md): `POST /v1/leads`. Create a lead, or enrol an existing one, optionally in a campaign.
- [List leads](https://docs.versionseven.ai/api-reference/leads/list-leads.md): `GET /v1/leads`. Get leads with optional filters.
- [Retrieve a lead](https://docs.versionseven.ai/api-reference/leads/retrieve-lead.md): `GET /v1/leads/{lead_id}`. Get a single lead by ID.
- [Update a lead](https://docs.versionseven.ai/api-reference/leads/update-lead.md): `PATCH /v1/leads/{lead_id}`. Update a lead by ID.
- [Delete a lead or remove it from a campaign](https://docs.versionseven.ai/api-reference/leads/remove-lead-from-campaign.md): `DELETE /v1/leads/{lead_id}`. Delete a lead, or with campaign_id, remove it from one campaign and keep its record.

## Endpoints: Campaigns

- [List campaigns](https://docs.versionseven.ai/api-reference/campaigns/list-campaigns.md): `GET /v1/campaigns`. Get campaigns for an organization.
- [Create a campaign](https://docs.versionseven.ai/api-reference/campaigns/create-campaign.md): `POST /v1/campaigns`. Create a draft campaign.
- [Retrieve a campaign](https://docs.versionseven.ai/api-reference/campaigns/retrieve-campaign.md): `GET /v1/campaigns/{campaign_id}`. Get campaign details by ID.
- [Update a campaign](https://docs.versionseven.ai/api-reference/campaigns/update-campaign.md): `PATCH /v1/campaigns/{campaign_id}`. Rename a campaign, activate or pause it, or turn the AI Appointment Setter on or off.
- [Replace a campaign's sequence](https://docs.versionseven.ai/api-reference/campaigns/replace-sequence.md): `PUT /v1/campaigns/{campaign_id}/sequence`. Replace a campaign's whole sequence (validated before saving).
- [Update a sequence step](https://docs.versionseven.ai/api-reference/campaigns/update-sequence-step.md): `PATCH /v1/campaigns/{campaign_id}/sequence/steps/{step_id}`. Patch a single sequence step by id (searches conditional branches; whole sequence re-validated).
- [Get campaign analytics](https://docs.versionseven.ai/api-reference/campaigns/get-campaign-analysis.md): `GET /v1/campaigns/{campaign_id}/analysis`. Aggregate analytics for a campaign: lead states, funnel counts and rates, reply sentiment and per-channel stats.
- [Get a campaign's queue](https://docs.versionseven.ai/api-reference/campaigns/get-campaign-queue.md): `GET /v1/campaigns/{campaign_id}/queue`. Queue depth and runway for a campaign: backlog, in-progress and completed leads, and daily capacity.
- [Get the activation preflight](https://docs.versionseven.ai/api-reference/campaigns/get-campaign-preflight.md): `GET /v1/campaigns/{campaign_id}/preflight`. The activation readiness checks for a campaign, without activating it: what would block activation and what would only warn.
- [Assign sender accounts](https://docs.versionseven.ai/api-reference/campaigns/assign-senders.md): `PUT /v1/campaigns/{campaign_id}/senders`. Set which connected sender accounts send for a campaign. Replaces the current set.
- [List AI fields](https://docs.versionseven.ai/api-reference/campaigns/list-ai-fields.md): `GET /v1/campaigns/{campaign_id}/ai-fields`. The campaign's AI fields: per-lead variables written before each message and used as {field_name} in its steps.
- [Create an AI field](https://docs.versionseven.ai/api-reference/campaigns/create-ai-field.md): `POST /v1/campaigns/{campaign_id}/ai-fields`. Add an AI field to a campaign: a per-lead variable, its instructions, where to research it, and the fallback used when personalization fails.
- [Update an AI field](https://docs.versionseven.ai/api-reference/campaigns/update-ai-field.md): `PATCH /v1/campaigns/{campaign_id}/ai-fields/{field_id}`. Change an AI field's instructions, fallback, description or data sources, or set is_active: false to stop generating it.
- [Get the reply agent](https://docs.versionseven.ai/api-reference/campaigns/get-responder.md): `GET /v1/campaigns/{campaign_id}/responder`. The campaign's AI Appointment Setter configuration: whether it answers replies, where it sends interested prospects, and what it may share.
- [Update the reply agent](https://docs.versionseven.ai/api-reference/campaigns/update-responder.md): `PATCH /v1/campaigns/{campaign_id}/responder`. Configure the AI Appointment Setter: turn it on or off, set the goal link, the assets it may share, its tone and instructions.
- [Preview a campaign's messages](https://docs.versionseven.ai/api-reference/campaigns/preview-campaign.md): `POST /v1/campaigns/{campaign_id}/preview`. Render variation A for a few real leads in the campaign, as the sender would, with every AI field at its fallback value.
- [List meetings booked](https://docs.versionseven.ai/api-reference/campaigns/list-bookings.md): `GET /v1/campaigns/{campaign_id}/bookings`. Meetings booked from a campaign, newest first: calendar bookings, plus leads the reply agent or a person confirmed as booked.
- [Turn A/B testing on or off](https://docs.versionseven.ai/api-reference/campaigns/set-ab-testing.md): `POST /v1/campaigns/{campaign_id}/ab-testing`. Turn a campaign's A/B test on or off and set the share of new leads that get variation A.
- [Promote an A/B winner](https://docs.versionseven.ai/api-reference/campaigns/promote-ab-winner.md): `POST /v1/campaigns/{campaign_id}/ab-testing/promote`. End an A/B test in one arm's favour, so every new lead gets the winning variation.
- [Get daily stats](https://docs.versionseven.ai/api-reference/campaigns/get-daily-stats.md): `GET /v1/campaigns/{campaign_id}/daily-stats`. One row per UTC day of sends, opens, connection requests and acceptances, replies by sentiment, leads first contacted, replied and positive, and meetings booked.
- [Get the step funnel](https://docs.versionseven.ai/api-reference/campaigns/get-step-funnel.md): `GET /v1/campaigns/{campaign_id}/step-funnel`. Per step of the sequence: how many leads reached it, are waiting at it, and replied to it.
- [Get the sender breakdown](https://docs.versionseven.ai/api-reference/campaigns/get-sender-breakdown.md): `GET /v1/campaigns/{campaign_id}/senders/breakdown`. Per-sender outbound and reply counts, with rates: messages and connection requests sent, acceptances, and the leads each sender contacted, got replies from and got positive replies from.
- [Get personalization quality](https://docs.versionseven.ai/api-reference/campaigns/get-personalization-quality.md): `GET /v1/campaigns/{campaign_id}/personalization-quality`. How each AI personalization field has been resolving at send time: runs by outcome, and how often the model reported too little data to write it.
- [Compare A/B cohorts](https://docs.versionseven.ai/api-reference/campaigns/get-ab-cohorts.md): `GET /v1/campaigns/{campaign_id}/ab-cohorts`. How each A/B variation is doing, counted over leads first contacted since the test began, so the arms compare directly.
- [List a campaign's webhooks](https://docs.versionseven.ai/api-reference/campaigns/list-webhooks.md): `GET /v1/campaigns/{campaign_id}/webhooks`. List all webhook subscriptions for a campaign.
- [Create a webhook](https://docs.versionseven.ai/api-reference/campaigns/create-webhook.md): `POST /v1/campaigns/{campaign_id}/webhooks`. Register a webhook to receive this campaign's prospect responses.
- [Delete a webhook](https://docs.versionseven.ai/api-reference/campaigns/delete-webhook.md): `DELETE /v1/campaigns/{campaign_id}/webhooks/{webhook_id}`. Stop delivering this campaign's responses to a webhook.
- [Set or rotate a webhook secret](https://docs.versionseven.ai/api-reference/campaigns/rotate-webhook-secret.md): `POST /v1/campaigns/{campaign_id}/webhooks/{webhook_id}/secret`. Set or replace a webhook's signing secret.

## Endpoints: Pipelines

- [List pipelines](https://docs.versionseven.ai/api-reference/crm-pipelines/list-pipelines.md): `GET /v1/crm/pipelines`. Get all pipelines.
- [Retrieve a pipeline](https://docs.versionseven.ai/api-reference/crm-pipelines/retrieve-pipeline.md): `GET /v1/crm/pipelines/{pipeline_id}`. Get a pipeline by ID.
- [Update a pipeline](https://docs.versionseven.ai/api-reference/crm-pipelines/update-pipeline.md): `PATCH /v1/crm/pipelines/{pipeline_id}`. Update a pipeline.

## Endpoints: Deals

- [List deals](https://docs.versionseven.ai/api-reference/crm-deals/list-deals.md): `GET /v1/crm/deals`. Get deals with optional filters.
- [Create a deal](https://docs.versionseven.ai/api-reference/crm-deals/create-deal.md): `POST /v1/crm/deals`. Create a new deal.
- [Retrieve a deal](https://docs.versionseven.ai/api-reference/crm-deals/retrieve-deal.md): `GET /v1/crm/deals/{deal_id}`. Get a single deal by ID.
- [Update a deal](https://docs.versionseven.ai/api-reference/crm-deals/update-deal.md): `PATCH /v1/crm/deals/{deal_id}`. Update a deal by ID.

## Endpoints: Reference

- [List sequence templates](https://docs.versionseven.ai/api-reference/reference/list-sequence-templates.md): `GET /v1/sequence-templates`. Blank sequence skeletons (multichannel / linkedin_only / email_only).
- [List webhook examples](https://docs.versionseven.ai/api-reference/reference/list-webhook-examples.md): `GET /v1/webhooks/examples`. Example payloads your webhook endpoint will receive.

## Webhook events

- [prospect_response webhook event](https://docs.versionseven.ai/api-reference/webhooks/prospect-response.md): Sent to a campaign's webhooks when a prospect replies.

## Cookbook

- [Cookbook](https://docs.versionseven.ai/cookbook.md): End-to-end recipes that combine several endpoints into a working integration.
- [Add CRM contacts to a campaign](https://docs.versionseven.ai/cookbook/add-crm-contacts.md): A script that adds contacts exported from your CRM to a Victoria AI campaign, safe to re-run, handling existing leads, invalid rows and rate limits.
- [Post prospect replies to Slack](https://docs.versionseven.ai/cookbook/post-replies-to-slack.md): A small server that receives the prospect_response webhook, verifies its signature, skips duplicates, and posts the reply to a Slack channel.

## Optional

- [Create a standalone lead](https://docs.versionseven.ai/api-reference/leads/create-standalone-lead.md): `POST /v1/leads/create`. Create a standalone lead.
- [Activate a webhook](https://docs.versionseven.ai/api-reference/campaigns/activate-webhook.md): `POST /v1/campaigns/{campaign_id}/webhook/activate`. Create a new webhook subscription for a campaign.
- [Deactivate a webhook](https://docs.versionseven.ai/api-reference/campaigns/deactivate-webhook.md): `POST /v1/campaigns/{campaign_id}/webhook/deactivate`. Deactivate a specific webhook subscription for a campaign.
- [List sequence templates](https://docs.versionseven.ai/api-reference/campaigns/list-sequence-templates.md): `GET /v1/campaigns/sequence-templates`. Blank sequence skeletons.
- [List webhook examples](https://docs.versionseven.ai/api-reference/campaigns/list-webhook-examples.md): `GET /v1/campaigns/webhook/examples`. Example webhook payloads.
- [llms-full.txt](https://docs.versionseven.ai/llms-full.txt): every page above except this section, in one file.
- [OpenAPI specification](https://docs.versionseven.ai/openapi.json): the machine-readable API description this reference is generated from.