---
title: "Create contact"
method: POST
path: "/contact/create"
tags: ["contact"]
---

# Create contact

`POST /contact/create`

This endpoint allows you to create a new **Contact**. A contact represents a person with whom you can interact via a phone call or other communication.

## Request body

- object
  - `phone_number` string, required — The phone number of the **Contact**. This is required to initiate calls.
  - `name` string — The name of the **Contact**.
  - `email` string — The email address associated with the **Contact** (optional).
  - `country_code` string — The country code for the **Contact**'s phone number.
  - `tags` string[] — Tags associated with the **Contact** to help categorize or segment them.
  - `attributes` object — Custom attributes you can assign to the **Contact**. These can be referenced in the **Agent** script.

## Response `200`

Successful response

- GenericResponse — The generic response format for all API requests. This structure ensures consistency in how success and error information is returned to the caller.
  - `error` object, nullable — An object containing error details, if any. This field will be populated if the API request fails or encounters an error. If the request is successful, this field will be null or omitted.
  - `data` object, required — Contains the response data for the successful request. This field will vary based on the specific API endpoint being called and contains the main data returned from the API. For example, it may include information about a created contact, agent, or webhook subscription.

---

[API](https://skmtc.dev/thoughtly/apis/thoughtly-api.md) · [All operations](https://skmtc.dev/thoughtly/apis/thoughtly-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thoughtly/thoughtly-api/revisions/75a10c67731a/schema)