# 등록

## 레코드 생성하기 <a href="#create-record" id="create-record"></a>

{% hint style="info" %}
개별 오브젝트의 {slug} 정보는 [slug](/integrations/http-api/slug.md) 페이지에서 확인할 수 있습니다.
{% endhint %}

<pre class="language-url"><code class="lang-url"><a data-footnote-ref href="#user-content-fn-1">POST</a> https://api.trackit.so/v1/objects/{slug}/records
</code></pre>

## Request Body

* values : 등록할 레코드의 속성 정보를 포함하는 객체입니다.

**설명**

* 생성할 레코드 정보를 속성별 배열 형태로 전달합니다.
* 각 필드의 이름과 값을 JSON 객체 내의 배열로 지정합니다.

**예시 :** 이름, 이메일 정보로 고객 레코드 생성

{% code lineNumbers="true" %}

```json
https://api.trackit.so/v1/objects/people/records
{
    "values": {
        "name": ["장토스"],
        "email-addresses": ["jang.toss@toss.im"]
    }
}
```

{% endcode %}

**속성명 확인**

레코드의 각 속성명은 '설정 > 워크스페이스 > API' 메뉴에서 확인할 수 있습니다.

<figure><img src="/files/vbTNRjrj5xWTpyECfNLn" alt=""><figcaption><p>노출 속성명, API 속성명 확인 방법</p></figcaption></figure>

## Error Handling

[에러 처리](/integrations/http-api/error-handling.md) 페이지를 참고하세요.

## Tips

* '고객' 레코드 등록 시 이메일 정보가 포함되어 있으면 '회사' 레코드도 자동 생성됩니다.
* 회사 레코드 등록 시 'team' 속성에 이메일 주소를 배열로 전달하면 '고객' 레코드도 함께 생성합니다.
* 회사, 고객 레코드 등록 시 각각 이메일(email-addresses), 도메인(domains) 정보로 중복을 검사합니다.

[^1]: POST


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trackit.so/integrations/http-api/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
