---
title: Overview | API Docs
---

## Chats

A Chat is a collection of Chat Messages.

To begin a chat thread, you must create a Chat with at least one phone\_number and one message.

Including multiple phone\_numbers would create a group Chat.

The phone\_number that all messages will originate from is based on your X-LINQ-INTEGRATION-TOKEN.

You do not have to include your phone\_number in the phone\_numbers array when creating a Chat, only the recipients’ phone\_numbers.

A PhoneNumber is always normalized on Linq’s end to assume a US country code, and append a +1 where no country code is provided. Phone Number format should be +12223334444 or 2223334444.

## Operations

GET

[/api/partner/v2/chats](/v2/api/operations/apipartnerv2chats/get/index.md)

POST

[/api/partner/v2/chats](/v2/api/operations/apipartnerv2chats/post/index.md)

GET

[/api/partner/v2/chats/{chat\_id}](/v2/api/operations/apipartnerv2chatschat_id/index.md)

GET

[/api/partner/v2/chats/find](/v2/api/operations/apipartnerv2chatsfind/index.md)

PUT

[/api/partner/v2/chats/{chat\_id}/mark\_as\_read](/v2/api/operations/apipartnerv2chatschat_idmark_as_read/index.md)

POST

[/api/partner/v2/chats/{chat\_id}/start\_typing](/v2/api/operations/apipartnerv2chatschat_idstart_typing/index.md)

DELETE

[/api/partner/v2/chats/{chat\_id}/stop\_typing](/v2/api/operations/apipartnerv2chatschat_idstop_typing/index.md)

POST

[/api/partner/v2/chats/{chat\_id}/share\_contact](/v2/api/operations/apipartnerv2chatschat_idshare_contact/index.md)