---
title: "Create a contact"
method: POST
path: "/teams/{teamKey}/contacts/"
---

# Create a contact

`POST /teams/{teamKey}/contacts/`

Create a new [contact](reference#read-a-contact-1). All contacts are scoped to a particular [team](reference#get-teams) so a `teamKey` is required. When creating a contact you can provide all of the contact info in a single call. See the possible parameters below.

Contacts must have at least one of `name` or `emailaddresses` set.

Note: Including the parameter `getIfExisting` limits the parameters you can include in the call.

## Path parameters

- `teamKey` string, required

## Query parameters

- `getIfExisting` boolean

## Request body

- object
  - `givenName` string — First name
  - `familyName` string — Last name
  - `emailAddresses` string[], required — The only email addresses associated with the contact will be the ones you include here; make sure to include any previously associated addresses as well as the new one(s).
  - `title` string — Contact's title/description
  - `other` string — Notes or other uncategorized information.
  - `addresses` string[] — The only addresses associated with the contact will be the ones you include here; make sure to include any previously associated addresses as well as the new one(s).
  - `phoneNumbers` string[] — The only phone numbers associated with the contact will be the ones you include here; make sure to include any previously associated numbers as well as the new one(s).
  - `twitterHandle` string
  - `facebookHandle` string
  - `linkedinHandle` string
  - `photoUrl` string

## Response `200`

200

- object
  - `teamKey` string
  - `givenName` string
  - `familyName` string
  - `title` string
  - `emailAddresses` string[]
  - `phoneNumbers` string[]
  - `addresses` string[]
  - `creationDate` integer
  - `key` string
  - `lastSavedTimestamp` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/streakyc/apis/directory-fields.md) · [All operations](https://skmtc.net/streakyc/apis/directory-fields/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streakyc/directory-fields/versions/f9ece0b33f19/schema)