> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.googleContacts.core.CreateContact

- Component: `appmixer.googleContacts.core.CreateContact`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.googleContacts 1.1.2](https://connectors.appmixer.com/connector/appmixer.googleContacts/1.1.2.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.googleContacts/1.1.2/component/appmixer.googleContacts.core.CreateContact>

Creates a new contact.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| First Name (`firstName`) | text | - |
| Family Name (`familyName`) | text | - |
| Emails (`emails`) | expression | - |
| Phone Numbers (`phones`) | expression | - |
| Notes (`notes`) | text | - |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Contact ID (`id`) | string | - |
| ETag (`etag`) | string | - |
| Update Time (`updateTime`) | string | - |
| Display Name (`displayName`) | string | - |
| First Name (`givenName`) | string | - |
| Display Name Last First (`displayNameLastFirst`) | string | - |
| Unstructured Name (`unstructuredName`) | string | - |
| Photo URL (`photoUrl`) | string | - |
| Memberships (`memberships`) | array | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.googleContacts.core.CreateContact",
  "author": "Appmixer <info@appmixer.com>",
  "description": "Creates a new contact.",
  "version": "1.0.0",
  "private": false,
  "auth": {
    "service": "appmixer:googleContacts",
    "scope": [
      "https://www.googleapis.com/auth/contacts"
    ]
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string"
          },
          "familyName": {
            "type": "string"
          },
          "emails": {
            "type": "object"
          },
          "phones": {
            "type": "object"
          },
          "notes": {
            "type": "string"
          }
        },
        "required": [
          "firstName"
        ]
      },
      "inspector": {
        "inputs": {
          "firstName": {
            "type": "text",
            "label": "First Name",
            "index": 0
          },
          "familyName": {
            "type": "text",
            "label": "Family Name",
            "index": 1
          },
          "emails": {
            "index": 2,
            "type": "expression",
            "label": "Emails",
            "levels": [
              "ADD"
            ],
            "fields": {
              "value": {
                "type": "text",
                "label": "Email",
                "index": 1
              },
              "displayName": {
                "type": "text",
                "label": "Display Name",
                "index": 2
              },
              "type": {
                "type": "select",
                "label": "Type",
                "options": [
                  {
                    "clearItem": true,
                    "label": "<empty>"
                  },
                  {
                    "value": "home",
                    "label": "Home"
                  },
                  {
                    "value": "work",
                    "label": "Work"
                  },
                  {
                    "value": "other",
                    "label": "Other"
                  }
                ],
                "index": 3
              }
            }
          },
          "phones": {
            "index": 3,
            "type": "expression",
            "label": "Phone Numbers",
            "levels": [
              "ADD"
            ],
            "fields": {
              "value": {
                "type": "text",
                "label": "Phone Number",
                "index": 1
              },
              "type": {
                "type": "select",
                "label": "Type",
                "options": [
                  {
                    "clearItem": true,
                    "label": "<empty>"
                  },
                  {
                    "value": "home",
                    "label": "Home"
                  },
                  {
                    "value": "work",
                    "label": "Work"
                  },
                  {
                    "value": "mobile",
                    "label": "Mobile"
                  },
                  {
                    "value": "homefax",
                    "label": "Home Fax"
                  },
                  {
                    "value": "workfax",
                    "label": "Work Fax"
                  },
                  {
                    "value": "otherFax",
                    "label": "Other Fax"
                  },
                  {
                    "value": "pager",
                    "label": "Pager"
                  },
                  {
                    "value": "workMobile",
                    "label": "Work Mobile"
                  },
                  {
                    "value": "workPager",
                    "label": "Work Pager"
                  },
                  {
                    "value": "main",
                    "label": "Main"
                  },
                  {
                    "value": "googleVoice",
                    "label": "Google Voice"
                  },
                  {
                    "value": "other",
                    "label": "Other"
                  }
                ],
                "index": 3
              }
            }
          },
          "notes": {
            "type": "text",
            "label": "Notes",
            "index": 4
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "options": [
        {
          "label": "Contact ID",
          "value": "id",
          "schema": {
            "type": "string",
            "example": "people/c1234567890123456"
          }
        },
        {
          "label": "ETag",
          "value": "etag",
          "schema": {
            "type": "string",
            "example": "%EgUBAi43PRoEAQIFByIMV3B2dUNUZkFXdz0="
          }
        },
        {
          "label": "Update Time",
          "value": "updateTime",
          "schema": {
            "type": "string",
            "example": "2026-01-15T10:30:00.000Z"
          }
        },
        {
          "label": "Display Name",
          "value": "displayName",
          "schema": {
            "type": "string",
            "example": "Michael Chen"
          }
        },
        {
          "label": "First Name",
          "value": "givenName",
          "schema": {
            "type": "string",
            "example": "Michael"
          }
        },
        {
          "label": "Display Name Last First",
          "value": "displayNameLastFirst",
          "schema": {
            "type": "string",
            "example": "Chen, Michael"
          }
        },
        {
          "label": "Unstructured Name",
          "value": "unstructuredName",
          "schema": {
            "type": "string",
            "example": "Michael Chen"
          }
        },
        {
          "label": "Photo URL",
          "value": "photoUrl",
          "schema": {
            "type": "string",
            "example": "https://lh3.googleusercontent.com/contacts/ANfB_t5_default"
          }
        },
        {
          "label": "Memberships",
          "value": "memberships",
          "schema": {
            "type": "array",
            "example": [
              {
                "metadata": {
                  "source": {
                    "type": "CONTACT",
                    "id": "4e3b2a1c0f9d8e7a"
                  }
                },
                "contactGroupMembership": {
                  "contactGroupId": "myContacts",
                  "contactGroupResourceName": "contactGroups/myContacts"
                }
              }
            ]
          }
        }
      ]
    }
  ],
  "icon": "(data URI omitted)"
}
```
