> For the complete documentation index, see [llms.txt](https://docs.trackit.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trackit.so/integrations/http-api/create.md).

# 등록

회사, 고객, 리드, 딜 등의 오브젝트에 API를 통해 레코드를 생성할 수 있습니다.

## 레코드 생성하기 <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="https://2878876032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRq4fnWeq5IbGJjjg5m62%2Fuploads%2FJRX3dA9YSOJJsUcJR3nN%2Fimage.png?alt=media&amp;token=4e721286-65f9-41af-a7dd-6228db59d58f" alt=""><figcaption><p>노출 속성명, API 속성명 확인 방법</p></figcaption></figure>

## Error Handling

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

## Tips

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

[^1]: POST