---
title: "Create new contact"
method: POST
path: "/contacts/public"
tags: ["Customers"]
---

# Create new contact

`POST /contacts/public`

## Request

- Base URL: `https://api.paperlessparts.com/v1`
- URL: `https://api.paperlessparts.com/v1/contacts/public`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/paperlessparts/apis/paperless-parts-api/docs/contacts/public/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new contact.

## Request body

- object
  - `account_id` integer, nullable: the ID of the associated Account
  - `address` object, nullable: the contact's address
    - `address1` string: The street address
    - `address2` string, nullable: Unit
    - `city` string: The city of the address
    - `country` string: The three character country abbreviation
    - `postal_code` string: The postal code for the address
    - `state` string: The two character state abbreviation
  - `email` string: email address (must be non-null, unique across all Contacts, and a valid email format)
  - `first_name` string: Contact first name (must be non-null)
  - `last_name` string: Contact last name (must be non-null)
  - `notes` string, nullable: Contact notes
  - `phone` string, nullable: Customer phone number
  - `phone_ext` string, nullable: Customer phone number extension
  - `salesperson` object, nullable: the contacts salesperson
    - `email` string: The salespersons email address. Must correspond to an active team member in your Paperless Parts account.

## Response `201`

Successful response

- Contact
  - `address` Address
    - `id` integer
    - `address1` string: (Required)
    - `address2` string, nullable: (Required)
    - `city` string: (Required)
    - `state` string: (Required) State/Province must be specified as standard postal abbreviation
    - `postal_code` string: (Required) US postal codes may optionally contain 4-digit extension, e.g., `'02114-1234'`
    - `country` string: (Required) Country must be ISO 3166-1 alpha-3 code. Currently allowed values are `'USA'`, `'CAN'`.
    - `erp_code` string: The unique identifier for this address record in the ERP
  - `account_id` integer, nullable: The ID of the associated account
  - `created` string
  - `email` string: (Required) email address (must be non-null, unique across all Customers, and a valid email format)
  - `first_name` string: (Required) Customer first name (must be non-null)
  - `id` integer
  - `last_name` string: (Required) Customer last name (must be non-null)
  - `notes` string, nullable: Customer notes
  - `phone` string, nullable: Customer phone number
  - `phone_ext` string, nullable: Customer phone number extension
  - `country_code` string, nullable
  - `metadata` object, nullable
  - `salesperson` SalesPerson
    - `uuid` string, uuid
    - `first_name` string
    - `last_name` string
    - `email` string, email
    - `erp_code` string

---

[API](https://skmtc.dev/paperlessparts/apis/paperless-parts-api.md) - [All operations](https://skmtc.dev/paperlessparts/apis/paperless-parts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paperlessparts/apis/paperless-parts-api/revisions/3eb132ead1fe?raw)