---
title: Create Contact | API Docs
---

POST

/api/partner/v2/contacts

Select code sample cURL (shell:curl)

```
const url = 'https://api.linqapp.com/api/partner/v2/contacts';
const options = {
  method: 'POST',
  headers: {
    'X-LINQ-INTEGRATION-TOKEN': '<X-LINQ-INTEGRATION-TOKEN>',
    'Content-Type': 'application/json'
  },
  body: '{"contact":{"first_name":"John","last_name":"Doe","email":"john@example.com","phone_number":"+15551234567","company":"Acme Corp","title":"CEO","location":"San Francisco, CA"}}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request POST \
  --url https://api.linqapp.com/api/partner/v2/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-LINQ-INTEGRATION-TOKEN: <X-LINQ-INTEGRATION-TOKEN>' \
  --data '{ "contact": { "first_name": "John", "last_name": "Doe", "email": "john@example.com", "phone_number": "+15551234567", "company": "Acme Corp", "title": "CEO", "location": "San Francisco, CA" } }'
```

- Production server api.linqapp.com/api/partner/v2/contacts

Creates a new contact. You can optionally specify a user\_email to assign the contact to a specific user in your organization. If not provided, the contact will be automatically associated with the first admin user.

**Note:** At least one of the following fields must be provided: `first_name`, `last_name`, `email`, or `phone_number`. Attempting to create a contact without any of these fields will result in a 422 validation error.

## Authorizations

- **[ApiKeyAuth](/v2/api/#apikeyauth/index.md)**

## Request Body required

Media type application/json

object

**contact**

required

object

**first\_name**

string

**last\_name**

string

**email**

string

**phone\_number**

string

**company**

string

**title**

string

**location**

string

**user\_email**

Optional email of the user in your organization who should own this contact. Must be an existing user in your organization. If not provided, defaults to the first admin user.

string

##### Examples

Select example withoutOwner

Create contact with default owner

```
{
  "contact": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "phone_number": "+15551234567",
    "company": "Acme Corp",
    "title": "CEO",
    "location": "San Francisco, CA"
  }
}
```

Create contact with specific owner

```
{
  "contact": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "phone_number": "+15551234567",
    "company": "Acme Corp",
    "title": "CEO",
    "location": "San Francisco, CA"
  },
  "user_email": "owner@company.com"
}
```

## Responses

### 201

Contact created successfully

Media type application/json

object

**data**

object

**id**

integer

**first\_name**

string

**last\_name**

string

**full\_name**

string

**email**

string

**phone\_number**

string

**company**

string

**title**

string

**location**

string

**image\_url**

string

nullable

**created\_at**

string format: date-time

**updated\_at**

string format: date-time

**contact\_owner**

The user who owns this contact in your organization

object

**id**

integer

**email**

string

**first\_name**

string

**last\_name**

string

**name**

string

##### Example

```
{
  "data": {
    "id": 123,
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "email": "john@example.com",
    "phone_number": "+15551234567",
    "company": "Acme Corp",
    "title": "CEO",
    "location": "San Francisco, CA",
    "image_url": null,
    "created_at": "2025-07-30T10:00:00.000-05:00",
    "updated_at": "2025-07-30T10:00:00.000-05:00",
    "contact_owner": {
      "id": 456,
      "email": "owner@company.com",
      "first_name": "Jane",
      "last_name": "Owner",
      "name": "Jane Owner"
    }
  }
}
```

### 422

Validation error or User not found

Media type application/json

Alternative error format used by Contacts and Webhook Subscriptions endpoints (render\_standard\_error format)

object

**status**

string

**error\_code**

string

**message**

string

**errors**

Array\<string>

##### Examples

Select example validation\_error

Validation error

```
{
  "status": "error",
  "error_code": "VALIDATION_ERROR",
  "message": "Contact validation failed",
  "errors": [
    "At least one of the name, email, or phone number fields must be filled out for the contact"
  ]
}
```

User not found

```
{
  "status": "error",
  "error_code": "USER_NOT_FOUND",
  "message": "Specified user not found",
  "errors": [
    "No user with email 'owner@company.com' exists in your organization"
  ]
}
```