---
title: "Ensure a contact exists or create a new one"
method: POST
path: "/contact/ensure"
tags: ["Contact"]
---

# Ensure a contact exists or create a new one

`POST /contact/ensure`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/contact/ensure`
- Auth: HTTP bearer

Ensure a contact with the given parameters exists or create a new one.

## Request body

- object: Instance crud properties
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `fingerprint` string, required: The fingerprint of the contact
  - `email` string: The email address of the contact
  - `phone` string: The phone number of the contact
  - `nick` string: The nickname of the contact
  - `preferences` string: The preferences of the contact
  - `verifiedAt` number: The timestamp (ms) when the contact was verified

## Response `200`

The contact was ensured successfully

- object
  - `id` string, required: The ID of the ensured contact

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)