---
title: "Create a contact for the customer"
method: POST
path: "/customers/{customer_id}/contacts"
tags: ["Customers"]
---

# Create a contact for the customer

`POST /customers/{customer_id}/contacts`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/customers/{customer_id}/contacts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/togaihq/apis/togai-apis/docs/customers/:customer_id/contacts/post.ts> (a function with typed inputs; its response is checked against the schema)

This API let’s you to create a contact for the customer

## Path parameters

- `customer_id` string, required

## Request body

- CreateCustomerContactRequest: Payload to create a contact for a customer
  - `preferredUsername` string
  - `name` string, required
  - `password` string
  - `email` string, required
  - `phone` string
  - `verified` boolean
  - `loginAccess` boolean

## Response `201`

Response for CreateCustomerContactRequest

- CreateCustomerContactResponse
  - `username` string, required
  - `preferredUsername` string
  - `name` string, required
  - `email` string
  - `phone` string
  - `loginAccess` boolean, required
  - `createdBy` string
  - `createdAt` string, date-time, required
  - `verified` boolean, required

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response
- `429`: Error response
- `default`: Error response

## Changes

- **2024-03-01** `6fb940b0dad9`: 1 info
  - endpoint added
- **2023-09-02** `6b13f6f47735`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/customers/:customer_id/contacts/post.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)
