---
title: "Contacts"
description: "The people in your address book.\n\nYou don't need contacts to send messages, but keeping them in sync means your team sees names\nin conversations, inbound messages and reports. A contact needs a `number`; name, email,\ngroups and custom fields are optional.\n\nTo keep one contact per number, create with `update_if_exists: true`, which updates the\nexisting contact instead of adding a duplicate. List endpoints are paginated and support\nsearch and sorting. See [Contacts and groups](/guides/contacts-and-groups/).\n"
version: "v2"
---

> Documentation Index
> Fetch the complete documentation index at: https://dev.touchsms.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

Path: touchSMS API

The people in your address book.

You don't need contacts to send messages, but keeping them in sync means your team sees names
in conversations, inbound messages and reports. A contact needs a `number`; name, email,
groups and custom fields are optional.

To keep one contact per number, create with `update_if_exists: true`, which updates the
existing contact instead of adding a duplicate. List endpoints are paginated and support
search and sorting. See [Contacts and groups](/guides/contacts-and-groups/).

## Operations

- [List contacts](/api/contacts/list/)
- [Create a contact](/api/contacts/create/)
- [Get a contact](/api/contacts/get/)
- [Update a contact](/api/contacts/update/)
- [Delete a contact](/api/contacts/delete/)


Source: https://dev.touchsms.com.au/api/tags/contacts/index.md