---
title: "Create Contact"
method: POST
path: "/companies/{companyId}/contacts"
tags: ["Contacts"]
---

# Create Contact

`POST /companies/{companyId}/contacts`

## Request

- Base URL: `https://api.pax8.com/v1`
- URL: `https://api.pax8.com/v1/companies/{companyId}/contacts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://token-manager.pax8.com/oauth/token`

Creates a new Contact

## Path parameters

- `companyId` string, uuid, required

## Request body

- Contact
  - `id` string, uuid: The id
  - `firstName` string, required: The first name
  - `lastName` string, required: The last name
  - `email` string, email, required: The email
  - `phone` string, phone, required: The phone number
  - `createdDate` string: The created date
  - `types` ContactType[]
    - `type` 'Admin' | 'Billing' | 'Technical': A company must have a primary contact for each contact type. A single contact can be marked as a primary contact for all types Contact Type: * `Admin` - Administrative contact * `Billing` - Billing contact * `Technical` - Technical contact
    - `primary` boolean: Is this contact the primary contact for this Contact Type

## Response `200`

Successful operation

- Contact
  - `id` string, uuid: The id
  - `firstName` string, required: The first name
  - `lastName` string, required: The last name
  - `email` string, email, required: The email
  - `phone` string, phone, required: The phone number
  - `createdDate` string: The created date
  - `types` ContactType[]
    - `type` 'Admin' | 'Billing' | 'Technical': A company must have a primary contact for each contact type. A single contact can be marked as a primary contact for all types Contact Type: * `Admin` - Administrative contact * `Billing` - Billing contact * `Technical` - Technical contact
    - `primary` boolean: Is this contact the primary contact for this Contact Type

## Other responses

- `404`: Company not found
- `422`: Invalid contact create

---

[API](https://skmtc.dev/pax8/apis/partner-endpoints.md) - [All operations](https://skmtc.dev/pax8/apis/partner-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/pax8/apis/partner-endpoints/revisions/f90cec5b4720?raw)