---
title: "Create a contact"
method: POST
path: "/api/v1/contacts"
---

# Create a contact

`POST /api/v1/contacts`

## Request

- Base URL: `https://memchats.com`
- URL: `https://memchats.com/api/v1/contacts`
- Auth: HTTP bearer

Subject to the plan contact limit. relationship_type is required: it drives the advisor tone and is the only way the user can tell their worlds apart. "other" is a valid answer.

## Request body

- object
  - `name` string, required
  - `display_name` string
  - `phone` string
  - `email` string, email
  - `telegram_username` string
  - `instagram_username` string
  - `relationship_type` 'partner' | 'ex_partner' | 'dating' | 'want_to_meet' | 'family' | 'friend' | 'acquaintance' | 'work_colleague' | 'work_boss' | 'work_subordinate' | 'cofounder' | 'client' | 'professional_service' | 'lawyer' | 'other', required
  - `context_note` string

## Response `200`

Created

## Other responses

- `400`: Missing or unknown relationship_type (code: relationship_required)
- `402`: Plan contact limit reached

---

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