Customers

The Customers endpoints let you manage customer accounts across your storefronts. You can create permanent or temporary user accounts, retrieve customer details including organization and tax exemption status, update profile information, transfer temporary user data to permanent accounts, and soft-delete customers.

Endpoints

Get Customer

Retrieve a customer's profile by their ID. Returns the full customer object including organization membership, user groups, and tax exemption status.

GET /api/v2/customer/{customerId}

Parameters

Example Request

curl -X GET https://api.printnow.com/api/v2/customer/12345 \
  -u "YOUR_TOKEN:YOUR_KEY"

Example Response

{
  "storefront": "My Print Store",
  "storefront_id": 1,
  "id": 12345,
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "jane@example.com",
  "username": "janesmith",
  "receive_marketing_emails": true,
  "last_logged_in_on": "2026-01-15T10:30:00Z",
  "created_on": "2025-06-01T14:00:00Z",
  "last_updated_on": "2026-01-15T10:30:00Z",
  "company": "Acme Corp",
  "organization": "Acme Organization",
  "user_groups": ["Wholesale", "VIP"],
  "tax_exempt": true,
  "is_temporary": false
}

Response Fields

Create Customer

Create a new customer account on a specific storefront. Set is_temporary to true to create a temporary (anonymous) user instead of a full account.

POST /api/v2/customer

Request Body (Permanent User)

Request Body (Temporary User)

Example Request

curl -X POST https://api.printnow.com/api/v2/customer \
  -u "YOUR_TOKEN:YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "storefront_id": 1,
    "username": "janesmith",
    "password": "securepass123",
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "company": "Acme Corp"
  }'

Returns the created customer object (same format as Get Customer). Creating a permanent customer triggers the customer_created webhook.

Update Customer

Update a customer's profile fields. Only the fields you include in the request body are updated; omitted fields remain unchanged.

PATCH /api/v2/customer/{customerId}

Updatable Fields (Permanent User)

Updating a permanent customer triggers the customer_updated webhook.

Converting a Temporary User

When you PATCH a temporary user with is_temporary set to false (or omitted), the API converts the temp account into a permanent one. This requires all the same fields as creating a new user (username, password, email, first_name, last_name). This triggers the customer_created webhook.

You cannot update a temporary user's information while keeping it temporary. Temp users can only be converted to permanent accounts or transferred.

Transfer Temporary User

Transfer all data (image albums, saved projects, and punchout sessions) from a temporary user to an existing permanent user. Both users must belong to the same storefront.

PATCH /api/v2/customer/{customerId}/transfer

Parameters

Request Body

Example Request

curl -X PATCH https://api.printnow.com/api/v2/customer/99999/transfer \
  -u "YOUR_TOKEN:YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": 12345}'

Returns the destination customer object on success. The source temp user's albums, projects, and punchout sessions are reassigned to the destination user.

Workflow: Temporary User Lifecycle

1. Create temp user -- POST /api/v2/customer with is_temporary: true. The system generates random credentials and returns a customer object.
2. Use temp user -- The temp user can browse, design, and save projects in the storefront.
3. Convert or transfer -- When the user is ready to check out:
   • New account: PATCH /api/v2/customer/{tempId} with full user details to convert the temp account into a permanent one.
   • Existing account: PATCH /api/v2/customer/{tempId}/transfer with the destination user's ID to move all work to an existing account.

Delete Customer

Soft-delete a customer account. The customer record is marked as deleted but not removed from the database. Temporary users cannot be deleted through this endpoint.

DELETE /api/v2/customer/{customerId}

Returns 204 No Content on success. Triggers the customer_deleted webhook.

Error Responses

Related Pages

• Authentication — API credentials required for all customer endpoints
• Webhooks — receive customer_created, customer_updated, and customer_deleted events
• Users — manage customer accounts and user groups in the admin UI