Join us at Google I/O from May 18 to 20 for discussions, learning, and a first look at our latest developer products. Register now.

Create contact point

Action ID

Construct a new contact. Populate the new contact's name and phone number using the and contactPoint.telephone intent parameters. Additionally populate the type of contact (like friend, family, or work) using the contactPoint.description intent parameter, if available.

Your app must confirm with the user before creating a contact.

Locale support

Functionality Locales
Preview creation using App Actions test tool en-US
User invocation from Google Assistant en-US

Example queries

The following fields represent essential information that users often provide in queries that trigger this built-in intent:

Other supported fields

The following fields represent information that users often provide to disambiguate their needs or otherwise improve their results:


Supported text values by field

Sample actions.xml

For information about the actions schema, read Create actions.xml.

Handle intent parameters as URL parameters

<?xml version="1.0" encoding="utf-8"?>
<!-- This is a sample actions.xml -->
  <action intentName="actions.intent.CREATE_CONTACT_POINT">
    <fulfillment urlTemplate="myapp://custom-deeplink{?telephone,description,name}">
      <!-- Eg. telephone = "+1-877-453-1304" -->
      <!-- (Optional) Require a field eg.telephone for fulfillment with required="true" -->
      <parameter-mapping urlParameter="telephone" intentParameter="contactPoint.telephone" required="true" />
      <!-- Eg. description = "Friend" -->
      <parameter-mapping urlParameter="description" intentParameter="contactPoint.description" />
      <!-- Eg. name = "John Doe" -->
      <parameter-mapping urlParameter="name" intentParameter="" />

    <!-- Provide a fallback fulfillment with no required parameters. For example, to your app search or router deeplink -->
    <fulfillment urlTemplate="myapp://deeplink" />

JSON-LD sample

The following JSON-LD sample provides some example values that you can use in the App Actions test tool:

  "@context": "",
  "@type": "ContactPoint",
  "contact": {
    "@type": "Person",
    "name": "John Doe"
  "description": "Friend",
  "telephone": "+1-877-453-1304"