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

## Linq Partner API 2.0.0

The Linq Partner API enables you to send and receive iMessages, RCS, and SMS at scale through your organization’s phone numbers. Build powerful messaging experiences, automate conversations, and integrate Linq’s messaging infrastructure directly into your applications.

Messages are automatically sent using the best available protocol: iMessage, then RCS, then SMS.

## Getting Started

All API requests use `https://api.linqapp.com` as the base URL and require authentication via the `X-LINQ-INTEGRATION-TOKEN` header. Your integration token determines which phone numbers you can message from and which organization data you can access.

```
curl https://api.linqapp.com/api/partner/v2/chats \
  -H "X-LINQ-INTEGRATION-TOKEN: your_token_here"
```

## Key Concepts

- **Chats**: Conversation threads with one or more participants
- **Messages**: Individual messages within a chat, supporting text, attachments, and reactions
- **Phone Numbers**: Your organization’s messaging-enabled phone numbers (iMessage, RCS, and SMS)
- **Contacts**: People in your organization’s address book
- **Webhooks**: Real-time notifications for incoming messages, reactions, and events

Linq Support

- <support@linqapp.com>

Informations

- OpenAPI version: `3.0.3`

## 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)

GET

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

POST

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

GET

[/api/partner/v2/chats/{chat\_id}/chat\_messages/{id}](/v2/api/operations/apipartnerv2chatschat_idchat_messagesid/get/index.md)

DELETE

[/api/partner/v2/chats/{chat\_id}/chat\_messages/{id}](/v2/api/operations/apipartnerv2chatschat_idchat_messagesid/delete/index.md)

POST

[/api/partner/v2/chats/{chat\_id}/chat\_messages/{id}/edit](/v2/api/operations/apipartnerv2chatschat_idchat_messagesidedit/index.md)

POST

[/api/partner/v2/chat\_messages/{chat\_message\_id}/reactions](/v2/api/operations/apipartnerv2chat_messageschat_message_idreactions/index.md)

GET

[/api/partner/v2/chat\_message\_reactions/{reaction\_id}](/v2/api/operations/apipartnerv2chat_message_reactionsreaction_id/index.md)

GET

[/api/partner/v2/contacts](/v2/api/operations/apipartnerv2contacts/get/index.md)

POST

[/api/partner/v2/contacts](/v2/api/operations/apipartnerv2contacts/post/index.md)

GET

[/api/partner/v2/contacts/{id}](/v2/api/operations/apipartnerv2contactsid/get/index.md)

PUT

[/api/partner/v2/contacts/{id}](/v2/api/operations/apipartnerv2contactsid/put/index.md)

DELETE

[/api/partner/v2/contacts/{id}](/v2/api/operations/apipartnerv2contactsid/delete/index.md)

PATCH

[/api/partner/v2/contacts/{id}](/v2/api/operations/apipartnerv2contactsid/patch/index.md)

GET

[/api/partner/v2/contacts/find](/v2/api/operations/apipartnerv2contactsfind/index.md)

GET

[/api/partner/v2/phone\_numbers](/v2/api/operations/apipartnerv2phone_numbers/index.md)

PUT

[/api/partner/v2/phone\_numbers/{id}](/v2/api/operations/apipartnerv2phone_numbersid/index.md)

GET

[/api/partner/v2/webhook\_subscriptions](/v2/api/operations/apipartnerv2webhook_subscriptions/get/index.md)

POST

[/api/partner/v2/webhook\_subscriptions](/v2/api/operations/apipartnerv2webhook_subscriptions/post/index.md)

PUT

[/api/partner/v2/webhook\_subscriptions/{webhook\_subscription\_id}](/v2/api/operations/apipartnerv2webhook_subscriptionswebhook_subscription_id/put/index.md)

DELETE

[/api/partner/v2/webhook\_subscriptions/{webhook\_subscription\_id}](/v2/api/operations/apipartnerv2webhook_subscriptionswebhook_subscription_id/delete/index.md)

GET

[/webhooks/events](/v2/api/operations/webhooksevents/index.md)

POST

[/api/partner/v2/i\_message\_availability/check](/v2/api/operations/apipartnerv2i_message_availabilitycheck/index.md)

## Authentication

### ApiKeyAuth

**Security scheme type:&#x20;**&#x61;piKey

**Header parameter name:&#x20;**&#x58;-LINQ-INTEGRATION-TOKEN