Updates: Check the release notes for new features and product updates.

Create an agent to manage brands

Stay organized with collections Save and categorize content based on your preferences.

An agent is a representation of a brand (and all the infrastructure that powers the representation) that users interact with on their devices.

As a registered partner, you can create Verified Calls agents, which let you use the Business Calls API and define the branding information displayed in conversations with users. When you register calls with Verified Calls, you call the API and associate the call with a particular agent.

For example, to make Verified Calls on behalf of the brand Growing Tree Bank, you create a Growing Tree Bank agent with Verified Calls. You use your partner credentials to authenticate API calls with Verified Calls and register or update calls as Growing Tree Bank, and the agent displays Growing Tree Bank's branding information on the user's call screen.

A Verified Call with branding information

If you manage multiple brands, create a Verified Calls agent for each brand.

By default, Verified Calls contacts a brand to perform branding verification each time you create an agent. If you anticipate creating multiple agents and would prefer Google to contact the brand once for bulk branding verification, businesscalls-support@google.com..

Create an agent

To create an agent, you need to gather and submit information about the brand and how you want the agent to appear to users.


Before you can create an agent, you need to gather the some information:

  • Partner name
  • Partner ID
  • Brand name
  • Agent name, as you want it to appear to users (maximum 18 characters)
  • Agent logo (500x500 px PNG or SVG with clear or white (#ffffff) background), as a publicly available URL

  • List of phone numbers of the agent. Phone numbers must be in E.164 format.

  • List of call reasons for the agent. Call reasons must be generic, not contain any sensitive information or promotional material.

  • Brand website
  • Name and email for an employee of the brand the agent represents who can verify your business relationship with the brand and your authority to represent the brand

Create the agent

Once you've gathered your information, it's time to create your agent.

  1. Open the Business Communications Developer Console and sign in with your Verified Calls Google account.
  2. Click Create agent.
  3. If you're prompted for Agent type, choose Verified Calls.
  4. Enter values for Brand name and Agent name.
  5. For Agent logo, upload your logo or specify a publicly-accessible URL, crop as needed, click the checkmark to confirm, and Select to proceed to the next screen.
  6. Enter the agent's phone numbers and call reasons.
  7. Enter the brand contact email, website, and your contact email.

  8. Click Finish setup.

Your agent appears in the agent list but is unavailable. After the brand approves your agent information, your agent becomes available.

Update agent information

You can update agent call reasons and phone numbers directly from the console. However, to update the details under Agent Information, you'll need to contact businesscalls-support@google.com. Identify the agent and the information that you want to update, including the new values. After you submit the new information, it can take up to three business days to update the agent information.

Next steps

Once you have created your agent, you can proceed to verify and launch the agent.