Quickstart - Crevio

Get an API key, make your first call, and create a real product — in three surfaces (cURL, SDK, MCP) and under five minutes. The Crevio API is a REST API. Every request is authenticated with a bearer token and hits https://api.crevio.co/v1. The official @crevio/sdk wraps it with types and retries, and the same operations are exposed to AI agents over MCP.

Get your key and make a call

Create an API key

In your dashboard, go to Settings → Developer and click New API token. Give it a descriptive name. The token is shown once — copy it and store it in an environment variable.

export CREVIO_API_TOKEN="your_token_here"

Treat tokens like passwords. Never commit them or ship them in client-side code. A token acts on behalf of your account.

Make your first call

The friendliest first call is GET /status — a lightweight health check that confirms your token works and tells you which account you’re authenticated as.

cURL
SDK (TypeScript)
MCP (agent)

curl https://api.crevio.co/v1/status \
  -H "Authorization: Bearer $CREVIO_API_TOKEN"

import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({ apiKeyAuth: process.env.CREVIO_API_TOKEN });

const status = await crevio.status.get();
console.log(status.status, status.account.name);

With Crevio’s MCP server connected, just ask:

Check my Crevio status and tell me which account I'm connected to.

A successful response looks like:

{
  "status": "operational",
  "api_version": "v1",
  "authenticated": true,
  "account": { "id": "acct_abc123", "name": "Acme Studio" },
  "documentation_url": "https://docs.crevio.co",
  "timestamp": "2026-06-21T10:30:00Z"
}

List your products

Now hit a real resource. List endpoints return a { object: "list", data: [...] } envelope.

cURL
SDK (TypeScript)
MCP (agent)

curl "https://api.crevio.co/v1/products?limit=5" \
  -H "Authorization: Bearer $CREVIO_API_TOKEN"

const products = await crevio.products.list({ limit: 5 });
for (const product of products) {
  console.log(product.id, product.name);
}

List my five most recent Crevio products.

Create your first product the right way

Publishing a product takes three calls in order. A product can’t go live without at least one price variant, so creating one with status: "active" in a single call fails with 422. Do it like this:

Create the product as a draft

Parameters go at the top level (not wrapped in a product key).

curl https://api.crevio.co/v1/products \
  -H "Authorization: Bearer $CREVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Intro to Watercolor",
    "status": "draft",
    "description": "A beginner-friendly painting course."
  }'

The response includes the new id, e.g. "id": "prod_abc123".

Add a price variant

Reference the product by its bare association name (product, not product_id) and its prefixed id. Money is in integer cents with a lowercase ISO currency.

curl https://api.crevio.co/v1/price_variants \
  -H "Authorization: Bearer $CREVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "prod_abc123",
    "name": "Full course",
    "amount_type": "fixed",
    "amount": 4900,
    "currency": "usd",
    "billing_type": "one_time"
  }'

amount: 4900 is $49.00. The response id looks like "id": "price_xyz789".

Publish the product

Now that a price exists, flip the product to active with a PATCH.

curl -X PATCH https://api.crevio.co/v1/products/prod_abc123 \
  -H "Authorization: Bearer $CREVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "active" }'

Prefer to skip the choreography? Ask the agent over MCP: “Create a one-time $49 course called Intro to Watercolor and publish it.” It runs the same three steps for you.

Next steps

Conventions

The full set of request and response rules — read before building.

Errors

Decode every status code and fix it fast.

TypeScript SDK

Type-safe access with automatic retries.

Usage & billing

How metered pay-per-call credits work.

​Get your key and make a call

​Create your first product the right way

​Next steps

Conventions

Errors

TypeScript SDK

Usage & billing

Get your key and make a call

Create your first product the right way

Next steps