---
title: "POST /v2/contacts"
method: POST
path: "/v2/contacts"
tags: ["contacts"]
---

# POST /v2/contacts

`POST /v2/contacts`

Create a new contact for the logged-in user

## Request body

- NewContact
  - `additional_name` string
  - `addresses` PostalAddress[]
    - `address_id` string
    - `city` string, required
    - `country` string
    - `is_primary` boolean
    - `label` string
    - `postal_code` string
    - `region` string
    - `street` string
    - `type` string
  - `avatar` string
  - `emails` NewEmail[]
    - `address` string, required
    - `is_primary` boolean
    - `label` string
    - `type` string
  - `family_name` string
  - `given_name` string
  - `title` string
  - `groups` string[]
  - `identities` SocialIdentity[]
    - `social_id` string
    - `infos` object
    - `name` string, required
    - `type` string
  - `ims` object[]
  - `infos` object
  - `name_prefix` string
  - `name_suffix` string
  - `organizations` object[]
  - `phones` Phone[]
    - `phone_id` string
    - `normalized_number` string
    - `is_primary` boolean
    - `number` string, required
    - `type` string
    - `uri` string
  - `public_keys` PublicKey[]
    - `alg` string
    - `crv` string
    - `date_insert` string, date-time
    - `date_update` string, date-time
    - `emails` string[]
    - `expire_date` string, date-time
    - `fingerprint` string
    - `kty` string
    - `key_id` string, required
    - `type` string
    - `resource_id` string, required
    - `resource_type` string
    - `size` integer
    - `use` string
    - `user_id` string, required
    - `x` integer
    - `y` integer
    - `key` string, required — DER or PEM key, base64 encoded
    - `label` string, required

## Response `200`

Contact created

- object
  - `location` string — url to retrieve new contact's infos at /contacts/{contact_id}
  - `contact_id` string

---

[API](https://skmtc.net/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.net/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/f32b5d08284d/schema)