Create a Contact

Create a Contact

POST https://ext-v2.smarttask.io/v{api-version}/contact/create/{organization_id}

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

Response

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": "[e-mail]",
            "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": "[e-mail]",
            "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": "[e-mail]"
        }
    ],
    "phones": [
        {
            "phone_number": "[phone]"
        }
    ],
    "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"
}