---
title: "Create a contact"
method: POST
path: "/v1/messenger/{channel_id}/contacts"
tags: ["Public Chat: Contacts"]
---

# Create a contact

`POST /v1/messenger/{channel_id}/contacts`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/messenger/{channel_id}/contacts`
- Auth: none required

Create a contact

## Request body

- PublicContactCreateUpdatePayload
  - `identifier` string: External identifier of the contact
  - `identifier_hash` string: Identifier hash prepared for HMAC authentication
  - `email` string: Email of the contact
  - `name` string: Name of the contact
  - `phone_number` string: Phone number of the contact
  - `avatar` string, binary: Send the form data with the avatar image binary or use the avatar_url
  - `custom_attributes` object: Custom attributes of the customer

## Response `200`

Success

- PublicContact
  - `id` integer: Id of the contact
  - `source_id` string: The session identifier of the contact
  - `name` string, nullable: Name of the contact when available
  - `email` string, nullable: Email of the contact
  - `phone_number` string, nullable: Phone number of the contact
  - `pubsub_token` string: The token to be used to connect to oxvo websocket

## Other responses

- `401`: Unauthorized

---

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