Skip to main content
More in Learn

Working with Customer Records

Crystallize provides multiple options for working with customer records. You can store as much or as little customer information as you need for your particular setup.

Managing Customers

Customer records may be created programmatically with the PIM API or as a result of orders being processed. You can then keep using the PIM API to maintain them as needed (refer to our example repository for customer-related GraphQL samples). You also have the option to manually create and maintain customer records within the Crystallize App. To perform these operations, you'll first need the requisite permissions for Customers (read, create, etc). Refer to our documentation on roles and permissions for more information.

Within the Crystallize App, click the Customers button on the left-hand panel. You can also bring up the command palette with CTRL+K or ⌘+K and type “Customers.”

On the Customers screen, click the plus sign button (+) at the top left or the +Add customer button in the middle of the screen to create a new customer record. When entering customer information, only first and last name are required. You can specify different billing and shipping addresses as needed. The Customer Metadata and External Reference fields can be used to store extra information that may be needed by your company or by other service providers that you’re using.

Orders and subscription contracts involving this customer, once created, will become visible here. For subscription contracts, you can access a detailed breakdown of metered variables and their current usage for the ongoing period. Predictive analytics provide estimates on future usage patterns and the associated total price. Leveraging data from past usage, this feature offers valuable foresight to empower informed decision-making.

Subscription contracts software metering

You can delete a customer by selecting them from the left-hand panel, then clicking the action button (...) at the top of the screen and choosing the Delete option. Note that orders placed by this customer in the past will be preserved, but any subscription contracts associated with them will be deleted. Proceed carefully with deletion.

Sample customer

Customer-Related Webhooks

You can (optionally) set up webhooks to subscribe to customer-related events. In Crystallize, events are fired whenever customers are

  • Created
  • Updated
  • Deleted

You can set up a webhook, then come up with your own way of responding to events. For more information, read about defining webhooks here.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community