---
title: "Create a customer contact"
method: POST
path: "/v3/customers/{customerId}/contacts"
tags: ["customers"]
---

# Create a customer contact

`POST /v3/customers/{customerId}/contacts`

Create a new customer contact.

When you create a customer contact, BILL enables the customer to sign in to the BILL web app with the `email` value and a random password. The signed-in customer can view invoices, make payments, and manage their account.

## Path parameters

- `customerId` string, required — BILL-generated ID of the customer. The value begins with `0cu`.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- CreateCustomerContactRequestDto — Create a customer contact
  - `firstName` string, required — Customer first name
  - `lastName` string — Customer last name
  - `email` string, email, required — Customer email address. The value must be unique in the organization.
  - `phone` string — Customer phone number
  - `altPhone` string — Customer alternate phone number. Use this field to sync with your accounting system.
  - `alternateEmail` string, email — Customer alternate email address. The customer cannot use this email address to sign in to the BILL web app.

## Response `201`

Create a customer contact response

- CustomerContactResponseDto — CustomerContact response Dto.
  - `id` string — BILL-generated ID of the customer contact. The value begins with `cpu`.
  - `archived` boolean — Set as `true` if the customer contact is archived.
  - `customerId` string — BILL-generated ID of the customer. The value begins with `0cu`.
  - `firstName` string — Customer first name
  - `lastName` string — Customer last name
  - `email` string — Customer email address
  - `phone` string — Customer phone number
  - `altPhone` string — Customer alternate phone number
  - `alternateEmail` string — Customer alternate email address
  - `createdTime` string, date-time — Created date and time
  - `updatedTime` string, date-time — Updated date and time

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/versions/0483350c434e/schema)