Method: people.createContact

Create a new contact and return the person resource for that contact.

HTTP request

POST https://people.googleapis.com/v1/people:createContact

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
personFields

string (FieldMask format)

Required. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fields if not set. Valid values are:

  • addresses
  • ageRanges
  • biographies
  • birthdays
  • coverPhotos
  • emailAddresses
  • events
  • genders
  • imClients
  • interests
  • locales
  • memberships
  • metadata
  • names
  • nicknames
  • occupations
  • organizations
  • phoneNumbers
  • photos
  • relations
  • residences
  • sipAddresses
  • skills
  • urls
  • userDefined
sources

enum (ReadSourceType)

Optional. A mask of what source types to return. Defaults to [ReadSourceType.CONTACT][google.people.v1.ReadSourceType.CONTACT] and [ReadSourceType.PROFILE][google.people.v1.ReadSourceType.PROFILE] if not set.

Request body

The request body contains an instance of Person.

Response body

If successful, the response body contains an instance of Person.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/contacts

For more information, see the Authorization guide.

Try it!