Skip to main content
Client Accounts and Workspaces

Create a Workspace and Assign Assets

Add a workspace to a client account, connect it to a Pod, and choose which agents, numbers, campaigns and other assets the client gets.

Written By voiceaiwrapper

Last updated 26 days ago

A workspace is what your client actually sees when they log in: one Pod, and only the agents, numbers, campaigns and other assets you choose from it. This article walks you through the Add Workspace wizard and explains the rules for assigning assets. Setting one up takes a few minutes.

Before you start

You'll need:

  • A client account. See Add a Client Account.
  • A connected Pod with the agents, phone numbers and campaigns you want to give this client already in it.
  • For Vapi, Retell AI and ElevenLabs Pods: webhooks synced on the agents and numbers you'll assign, so VoiceAIWrapper can track their calls. You can also sync them from inside the wizard. See Sync Webhooks So VoiceAIWrapper Can Track Calls.

The wizard has four steps: General Settings, Asset Assignment, Access Control and Review.

Step 1: Name the workspace and choose its Pod

  1. Open Client Accounts and click the client.
  2. Open the Workspaces tab and click Add Workspace.
  3. In Workspace Name, type a name. Your client sees it as their workspace name, and uses it to switch between workspaces if they have more than one.
  4. In VoiceAI Pod, choose the Pod. Each Pod is listed by its name with the engine in brackets, for example "Main (VAW Native)".
  5. Click Next.

Keep in mind:

  • The Pod can't be changed after you save. You can rename the workspace later, but to use a different Pod you need a new workspace.
  • A client can have one workspace per Pod. Pods this client already has a workspace on don't appear in the list.
  • Workspace names must be unique within the client account.

Step 2: Assign assets

Asset Assignment lists everything in the Pod that you can give to this client. Pick items from each section. Your client sees only what you pick here.

Add Workspace sheet on step 2, Asset Assignment, for a Vapi Pod. The stepper at the top shows General Settings done and Asset Assignment current. Visible sections: Assistants (two assistants selected), Workflows, Squads, Phone Numbers (one number selected), Knowledge Base, Tools and Campaigns (one campaign selected), each with its ? tooltip icon. Previous and Next buttons at the bottom. Blur phone numbers.

The sections you see depend on the Pod's engine:

SectionWhat you assignShown for
Assistants / AgentsThe voice agents the client can use. Vapi calls them Assistants; other engines say Agents.All engines
Chat AgentsRetell chat agents.Retell AI
Workflows, SquadsVapi workflows and squads.Vapi
Phone NumbersNumbers the client can see.All engines except Ultravox
Phone Number PoolPools of numbers for outbound calling.Plans that include Phone number pools
Knowledge BaseKnowledge bases the agents answer from.All engines
ToolsTools and functions the agents can use.Vapi, ElevenLabs and VAW Native
Call Data ExtractionsStructured data pulled from each call.VAW Native
CampaignsCampaigns the client can see and run. Most are listed with their current status.All engines

Hover over the ? next to a section name for a short description.

Assign at least one campaign and one agent. Until a workspace has both, the client's Overview marks it Empty, and the client sees no calls or data in it.

When you're done, click Next.

Vapi, Retell AI and ElevenLabs: sync webhooks first

VoiceAIWrapper tracks calls through a webhook on each agent and number in your provider account. If a selected item isn't pointing at VoiceAIWrapper, a Webhook Sync Required box appears under its section, for example "1 assistant needs to be synced with our webhook URL before proceeding."

The same Asset Assignment step with the yellow Webhook Sync Required box under Assistants: the message "1 assistant needs to be synced with our webhook URL before proceeding.", the assistant's name in the list, and the Sync now button on the right.

Click Sync now in the box. This updates the agent or number in your provider account so its calls are sent to VoiceAIWrapper. Then click Next.

You can't move past this step while a selected item is unsynced. Clicking Next shows an error such as "Some selected assistants/agents have invalid webhook URLs. Please sync them first." The same applies to phone numbers, Vapi squads (every assistant in the squad must be synced) and Vapi workflows.

On Vapi and Retell AI, the box for phone numbers says they need to be synced "and have default destination removed". Sync now does both in your provider account: it points the number at VoiceAIWrapper and removes the agent (or squad or workflow) the number was set to ring.

Syncing a Vapi or Retell AI number changes how it answers straight away. Incoming calls then go to the agent of the active inbound campaign that uses the number. If no inbound campaign uses it yet, set one up before you rely on the number. See Run an Inbound Phone Campaign.

VAW Native: ownership rules and limits

VAW Native Pods don't need webhook syncing. Two other rules apply instead:

  • An agent belongs to one client. If you pick an agent that's already in another client's workspace, saving fails with "Agent name already belongs to Client name. Remove it there first, then add it here." An agent can be in several workspaces of the same client.
  • A tool a client created stays theirs. Assigning it to another client's workspace fails with a message that the tool "belongs to another client and can only be assigned to their workspaces".

VAW Native workspaces also have limits, such as Maximum agents and Maximum phone numbers. They start at 1. If you select more than the limit, a warning appears under the section: "n selected but this workspace is limited to limit. Remove excess, or raise the limit on the Access Control step before saving." Raise the limit in the next step. The Maximum tools box only appears once Tools is at View & Edit with Create tools on. See Set Client Permissions on VAW Native Workspaces.

Step 3: Set access control

Access Control decides what the client can see and change in this workspace. The options depend on the engine:

Every workspace starts with default settings, so you can click Next and adjust them later. Check them before your client logs in: on Vapi, Retell AI and ElevenLabs, for example, Show prompt to client starts on.

Step 4: Review and save

Review summarises the workspace in three parts: General (name and Pod), Assigned Assets and Client Access.

  1. Check each part. Click Previous to go back and change anything.
  2. Click Save Workspace.

You'll see "Client account configuration created successfully", and the workspace appears in the list.

Two messages can appear here:

  • "This workspace assigns more than its limits allow, so it cannot be saved yet." (VAW Native.) Save Workspace stays greyed out, and the summary lists each limit you're over. Remove assets or raise the limits, then save.
  • "Every feature is hidden from the client. They will see a default empty-state message." This is a warning, not a block. The client will see nothing useful until you give them access to something.

Change a workspace

On the Workspaces tab, each row shows Name, ID, Pod and Created At. Use Search workspaces or the Pod Type filter to find one.

To change a workspace:

  1. Click Update on its row.
  2. Choose General Settings, Assets or Access. The wizard opens at that step.
  3. Make your changes, step through to Review, and click Update Workspace.

When you save new asset choices, VoiceAIWrapper replaces the assets you assigned with your new selection. Items your client created themselves in a VAW Native workspace, such as their own knowledge bases or extractions, stay in place.

Delete a workspace

  1. On the Workspaces tab, click the trash icon on the workspace's row.
  2. Confirm with Delete.

Deleting a workspace removes it and its asset assignments from the client account. The client's users lose access to everything in it straight away. The agents, numbers and campaigns themselves stay in your Pod. This can't be undone.

Frequently asked questions

Either this client already has a workspace on that Pod (each client can have one per Pod), or the Pod isn't connected to your organization. To change what an existing workspace shows, use Update β†’ Assets on it instead.

Check two things. First, the workspace needs at least one campaign and one agent: the client's Overview tab shows Empty next to workspaces that don't. Second, check Access Control: an area set to No Access doesn't appear in the portal. Log in as the client to see exactly what they see.

Yes. You can assign a campaign to a client and workspace from the campaign's page. See Assign a Campaign to a Client.

The sync updates the item in your provider account. If it fails, check that the Pod's API key is still valid, then try again. See Sync Webhooks So VoiceAIWrapper Can Track Calls.