Create a free trial

• Create a capped free trial on a limited set of products using time-bound credits, alerts, and entitlement overrides.
• Create an uncapped free trial using time-bound contract overrides.

​

Create a credit-based free trial​

• The customer has free access to the platform for up to one week after sign-up.
• The customer trial ends if they reach up to $100 of usage in the platform.
• The customer trial only includes a certain set of products. For example, the user is allowed to access the Language models functionality, but not Fine tuning or Image generation features.
• When the trial ends (due to time or usage) you receive a real-time notification from Metronome. This allows you to manage a customer’s state based on their usage in Metronome—for instance, send them an email that their trial has ended, or disable their account until they purchase further usage.

​

Pre-requisites​

​

Configure a contract with free trial credits​

1. On the Customers page, click on your customer.
2. Click New contract or plan -> New contract…
3. Configure the contract for your customer.
   
4. Click Add a credit to configure the trial terms.
5. (Optional) To help gate access to certain features while your customer is in the trial phase, set an override on the entitlement state for the particular rate. You can then read from this override to restrict access inside of your product.
6. Save your changes to create and submit the contract.

curl https://api.metronome.com/v1/contracts/create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
    "rate_card_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
    "starting_at": "2024-09-01T00:00:00.000Z",
    "ending_before": "2025-09-01T00:00:00.000Z",
    "name": "AcmeCorp List Prices",
    "credits": [
      {
        "name": "Trial credits",
        "product_id": "609e4cf2-6ea2-4b07-a46c-6596f041b69e",
        "access_schedule": {
          "schedule_items": [
            {
              "amount": 10000,
              "starting_at": "2024-09-01T00:00:00.000Z",
              "ending_before": "2024-09-08T00:00:00.000Z"
            }
          ]
        },
        "description": "Free usage as part of trial",
        "priority": 1
      }
    ],
    "overrides": [
      {
        "starting_at": "2024-09-01T00:00:00.000Z",
        "ending_before": "2024-09-08T00:00:00.000Z",
        "entitled": false,
        "applicable_product_tags": [
          "Fine tuning",
          "Images modeled"
        ]
      }
    ]
  }'

​

Track customer usage​

​

Create an alert to signal the end of the trial period​

1. Define an alert to notify you when the trial credits are fully consumed.

1. Receive the webhook from Metronome when the credit balance reaches 0.

​

Create an uncapped free trial​

• The customer has free access to the platform for up to one week after sign-up.
• The customer can use as much of the product as they want with no capped usage.
• The customer trial only includes a certain set of products. For example, the user is allowed to use the Language models functionality, but not Fine tuning or Image generation features.
• When the trial ends, the customer is automatically transitioned into a paid user.

​

Configure a contract with time-bound price overrides​

1. Follow steps 1 and 2 described in the section Configure a contract with free trial credits to create a contract for your customer.
2. Click + Add an override to create your free trial with a time-bound price override.
3. (Optional) To restrict access to certain products during the trial period, follow the entitlement override steps from step 5 in the section Configure contract with free trial credits .
4. Save your changes to create the contract.

curl https://api.metronome.com/v1/contracts/create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",
    "rate_card_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
    "starting_at": "2024-09-01T00:00:00.000Z",
    "ending_before": "2025-09-01T00:00:00.000Z",
    "name": "AcmeCorp List Prices",
    "overrides": [
      {
        "starting_at": "2024-09-01T00:00:00.000Z",
        "ending_before": "2024-09-08T00:00:00.000Z",
        "type": "multiplier",
        "multiplier": 0,
        "applicable_product_tags": [
          "Language models"
        ]
      },
      {
        "starting_at": "2024-09-01T00:00:00.000Z",
        "ending_before": "2024-09-08T00:00:00.000Z",
        "entitled": false,
        "applicable_product_tags": [
          "Fine tuning",
          "Images modeled"
        ]
      }
    ]
  }'