# Create a new contact

URL: /en/docs/api/v1/contacts/post
Last Updated: 2026-07-30T21:15:44.937Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/contacts

**Create a new contact**

Create a new contact. The contact will have a default review status of "to_review".

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `email` (string (email), required): Valid email address
- `first_name` (string, required): First name of the contact
- `last_name` (string): Last name of the contact
- `title` (string): Job title of the contact
- `locale` (enum: en | de | fr | ja | ko | zh): Optional Trust Center content locale for email and portal access.
- `review_status` (enum: to_review | in_review | approved | cancelled): Initial review status

Example (Basic contact for review):

```json
{
  "email": "john.doe@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "title": "Security Manager",
  "review_status": "to_review"
}
```

Example (Pre-approved contact):

```json
{
  "email": "jane.smith@trusted-partner.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "title": "CISO",
  "review_status": "approved"
}
```

Example (Minimal required fields):

```json
{
  "email": "contact@example.com",
  "first_name": "Alex"
}
```

**Responses:**

- `200` - Contact created successfully
  - `success` (boolean)
  - `data` (object)
    - `contact` (Contact (object))
      - `id` (string (uuid))
      - `email` (string (email))
      - `first_name` (string)
      - `last_name` (string)
      - `title` (string)
      - `review_status` (enum: to_review | in_review | approved | cancelled): Review status of the contact
      - `account` (object): Associated account information
      - `tenant` (string): Tenant ID this contact belongs to
      - `documents` (array of object): Documents shared with this contact
        - `documents_id` (string)
      - `access_requests` (array of object): Access requests made by this contact
      - `vendor` (object): Associated vendor record or vendor ID
      - `invitations` (array of object): Invitation records related to this contact
        - `id` (string)
        - `state` (string)
        - `accepted_at` (string (date-time))
        - `date_created` (string (date-time))
        - `date_updated` (string (date-time))
      - `nda_acceptances` (array of ContactNdaAcceptance (object)): Completed NDA acceptances related to this contact. Provider data and file identifiers are omitted from this list response.
        - `id` (string): NDA acceptance identifier
        - `contact` (string): Contact identifier that completed the NDA
        - `state` (string): NDA acceptance state
        - `date_created` (string (date-time)): NDA signature timestamp (ISO-8601)
        - `download_type` (enum: file | docusign): Sanitized source type for the downloadable signed NDA, when available
        - `has_download` (boolean): Whether the signed NDA can be downloaded from the acceptance file endpoint
      - `date_created` (string (date-time)): Contact creation timestamp (ISO-8601)
      - `date_updated` (string (date-time)): Contact last update timestamp (ISO-8601)
      - `custom_fields` (array of object): Custom field values for this contact
        - `id` (string)
        - `template` (object)
        - `value` (object)
- `400` - Bad Request - validation failed
  - `error` (string)
- `401` - Unauthorized
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/contacts" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "title": "Security Manager",
    "review_status": "to_review"
  }'

```