> For the complete documentation index, see [llms.txt](https://dev.smarttask.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.smarttask.io/endpoints/contact/create-contact.md).

# Create a Contact

## Create a Contact

<mark style="color:green;">`POST`</mark> `https://ext-v2.smarttask.io/v{api-version}/record/contact/create/{organization_id}`&#x20;

#### Path Parameters

| Name             | Type   | Description                              |
| ---------------- | ------ | ---------------------------------------- |
| api-version      | string | API Version - 1.0                        |
| organization\_id | number | OrganizationId of SmartTask organization |

#### Query Parameters

| Name         | Type    | Description                                                                                           |
| ------------ | ------- | ----------------------------------------------------------------------------------------------------- |
| use\_created | boolean | `true` - check if there is a similar contact if so, return the same instead of creating a new contact |

#### Headers

| Name          | Type   | Description                |
| ------------- | ------ | -------------------------- |
| Authorization | string | Authorization Bearer token |

#### Request Body

* Please refer to [Contact](/models/contact.md)

#### Response

{% tabs %}
{% tab title="200 " %}

```
{
    "custom_field_values": [],
    "description": "",
    "assigned_user": null,
    "followers": [
        {
            "email_confirmed": true,
            "role": "core",
            "job_role": null,
            "department": null,
            "about_me": null,
            "status_icon_url": null,
            "status_message": null,
            "status_out_of_office": false,
            "status_clear_at": null,
            "cost_per_hour": 50,
            "billable_rate_per_hour": 100,
            "capacity": {
                "mon_capacity_in_hours": 8,
                "tue_capacity_in_hours": 8,
                "wed_capacity_in_hours": 8,
                "thu_capacity_in_hours": 8,
                "fri_capacity_in_hours": 8,
                "sat_capacity_in_hours": 0,
                "sun_capacity_in_hours": 0,
                "weekly_capacity_in_hours": 40
            },
            "created_at": "2025-05-23T09:47:19.1655819Z",
            "modified_at": "2025-05-23T09:47:19.1655819Z",
            "user_id": 57,
            "full_name": "Mike Williams",
            "email": "mike@acme.io",
            "avatar_url": "https://smartstorage1.blob.core.windows.net/smarttask/organization/26/0303cfa3-ebce-4928-8e03-df260ec17686/mike.webp",
            "timezone_in_mins": null
        },
        {
            "email_confirmed": true,
            "role": "core",
            "job_role": null,
            "department": null,
            "about_me": null,
            "status_icon_url": null,
            "status_message": null,
            "status_out_of_office": false,
            "status_clear_at": null,
            "cost_per_hour": 50,
            "billable_rate_per_hour": 100,
            "capacity": {
                "mon_capacity_in_hours": 8,
                "tue_capacity_in_hours": 8,
                "wed_capacity_in_hours": 8,
                "thu_capacity_in_hours": 8,
                "fri_capacity_in_hours": 8,
                "sat_capacity_in_hours": 0,
                "sun_capacity_in_hours": 0,
                "weekly_capacity_in_hours": 40
            },
            "created_at": "2025-05-23T09:47:19.1656262Z",
            "modified_at": "2025-05-23T09:47:19.1656263Z",
            "user_id": 59,
            "full_name": "John",
            "email": "john@acme.io",
            "avatar_url": "https://smartstorage1.blob.core.windows.net/photos/UserPics/ec53bc94-1d43-438a-bb12-24eccdce600f.png",
            "timezone_in_mins": null
        }
    ],
    "record_id": "d46a122c-0bb3-4a7a-8c27-2138d3d3ab06",
    "organization_id": 38,
    "created_by_user_id": 59,
    "record_type": "contact",
    "record_sub_type": "person",
    "access_type": "default",
    "name": "Alex Johnson",
    "designation": null,
    "avatar_url": null,
    "assigned_user_id": null,
    "parent": {
        "record_id": "a7b85d7e-7da2-462d-8b45-aefdcebc4efd",
        "record_sub_type": "organization",
        "name": "Coca - Cola",
        "avatar_url": null,
        "parent_name": null,
        "designation": null,
        "archived": false
    },
    "address": null,
    "address_lat": null,
    "address_lng": null,
    "emails": [
        {
            "email": "alex.johnson@examplemail.com"
        }
    ],
    "phones": [
        {
            "phone_number": "+15551234567"
        }
    ],
    "url_details": {
        "domain": null,
        "twitter_url": null,
        "linkedin_url": null,
        "facebook_url": null,
        "github_url": null,
        "instagram_url": null
    },
    "projects": [],
    "files": [],
    "archived": false,
    "created_at": "2024-11-21T13:43:02.472",
    "modified_at": "2025-05-23T09:46:54.64"
}
```

{% endtab %}
{% endtabs %}