> ## Documentation Index
> Fetch the complete documentation index at: https://docs.printools.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Customers

> Customers, their contacts and addresses.

Use the operations below to work with customers. Each link opens an interactive reference page generated from the published OpenAPI specification.

## Operations

| Operation                                                                                               | Method and path                             | Required scopes                              |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------- | -------------------------------------------- |
| [List customers](/api/reference/get_v1_customers)                                                       | `GET /v1/customers`                         | `customers.read`                             |
| [Create a customer](/api/reference/post_v1_customers)                                                   | `POST /v1/customers`                        | `customers.write`                            |
| [One customer with contacts and addresses](/api/reference/get_v1_customers_customerId)                  | `GET /v1/customers/{customerId}`            | `customers.read`                             |
| [Update a customer](/api/reference/patch_v1_customers_customerId)                                       | `PATCH /v1/customers/{customerId}`          | `customers.write`                            |
| [Archive a customer](/api/reference/post_v1_customers_customerId_archive)                               | `POST /v1/customers/{customerId}/archive`   | `customers.write`                            |
| [Restore an archived customer](/api/reference/post_v1_customers_customerId_unarchive)                   | `POST /v1/customers/{customerId}/unarchive` | `customers.write`                            |
| [Add a contact to a customer](/api/reference/post_v1_customers_customerId_contacts)                     | `POST /v1/customers/{customerId}/contacts`  | `customers.write`                            |
| [Update a contact](/api/reference/patch_v1_contacts_contactId)                                          | `PATCH /v1/contacts/{contactId}`            | `customers.write`                            |
| [Delete a contact](/api/reference/delete_v1_contacts_contactId)                                         | `DELETE /v1/contacts/{contactId}`           | `customers.write`                            |
| [Add an address to a customer](/api/reference/post_v1_customers_customerId_addresses)                   | `POST /v1/customers/{customerId}/addresses` | `customers.write`                            |
| [Update an address](/api/reference/patch_v1_addresses_addressId)                                        | `PATCH /v1/addresses/{addressId}`           | `customers.write`                            |
| [Delete an address](/api/reference/delete_v1_addresses_addressId)                                       | `DELETE /v1/addresses/{addressId}`          | `customers.write`                            |
| [Create many customers in one call](/api/reference/post_v1_customers_bulk_create)                       | `POST /v1/customers/bulk/create`            | `customers.write`                            |
| [Archive or restore every customer matching a target](/api/reference/post_v1_customers_bulk_archive)    | `POST /v1/customers/bulk/archive`           | `customers.write`                            |
| [Set the tier of every customer matching a target](/api/reference/post_v1_customers_bulk_tier)          | `POST /v1/customers/bulk/tier`              | `customers.write`                            |
| [One customer with their quotes and jobs, in one call](/api/reference/get_v1_customers_customerId_data) | `GET /v1/customers/{customerId}/data`       | `customers.read`, `quotes.read`, `jobs.read` |

See [Authentication](/api/authentication) before your first call. For write retries, see [Writing safely](/api/idempotency).