# Contacts API

Source: https://joinsimplesms.com/changelog/2026-10-04-contacts-api
Index: https://joinsimplesms.com/llms.txt

October 4, 2026

- **`/v1/contacts`**: create-or-update by phone number, retrieve, update,
  delete, and list with `tag` and `phone_number` filters. The same
  address book the console uses. See [Contacts](/docs/contacts).
- **`POST /v1/contacts/import`**: bulk upsert, up to 500 per request, with
  skipped rows reported by index.
- **`POST /v1/contacts/bulk`**: add tags, remove tags, or delete for up to
  500 contacts in one call.
- New key scope `contacts`. `contacts` resource in the Node and Python
  SDKs.