Package Information
Documentation
n8n-nodes-crevio
This is an n8n community node. It lets you use Crevio in your n8n workflows.
Crevio runs a small business with an AI agent: products, checkout and payments, customers, bookings, invoices and marketing. This package gives n8n two nodes:
- Crevio: work with customers, products, orders, checkouts, subscriptions, refunds, bookings, discount codes and invoices, and hand jobs to the Crevio agent in plain language. It can also be used as a tool by n8n's AI Agent.
- Crevio Trigger: start a workflow when something happens in Crevio, such as a paid order, a new lead or a cancelled booking.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Example workflows
Resources
Version history
Installation
Follow the installation guide in the n8n community nodes documentation. The package name is n8n-nodes-crevio.
Operations
Crevio
| Resource | Operations |
|---|---|
| Agent | Send Message, Send Follow-Up Message, Get Run |
| Booking | Create, Cancel, Get, Get Many, Get Available Slots |
| Checkout | Create, Get |
| Customer | Create, Update, Delete, Get, Get Many, Add Tag, Remove Tag |
| Discount | Create, Delete, Get, Get Many |
| Invoice | Create, Get, Get Many, Void |
| Order | Get, Get Many |
| Product | Create, Update, Delete, Get, Get Many |
| Refund | Create, Get, Get Many |
| Subscription | Cancel, Pause, Resume, Get, Get Many |
Get and Get Many operations return the ten most useful fields by default. Turn off Simplify to get the full object.
Agent hands a job to the Crevio agent, which works your account the way it does in a Crevio chat: "Email everyone who bought the watercolor course this week a thank-you note", "Which products sold best last month?". The reply is in result. Add a Response Schema to get the reply as JSON in json. If the agent is still working after Wait for Reply, the run comes back with status pending or running; read it later with Get Run. The agent spends Crevio credits, as it does in the app.
Crevio Trigger
Starts a workflow on any of Crevio's webhook events, including:
- Commerce:
order.created,order.paid,order.disputed,checkout.created,refund.created,subscription.created,subscription.renewed,subscription.canceled,subscription.ended,invoice.paid - Leads and customers:
lead.created,form_submission.created,customer.tag_added,customer.tag_removed - Bookings:
booking.created,booking.cancelled,booking.rescheduled - The agent and email:
task_run.completed,task_run.needs_input,email_message.received,call.ended
The full list and each event's payload are in the Crevio webhooks guide. When you activate the workflow, the trigger registers a webhook in your Crevio account, and it removes it when you deactivate the workflow. Every delivery is checked against its signature; requests that are not signed by Crevio are rejected.
Credentials
You need a Crevio API key. API keys are available on Crevio's Business plan.
- In Crevio, open Settings → Developer.
- Under API Keys, click Create key and give it a name, such as
n8n. - Under What it can do, pick Read data and Create, change and delete data. For the Agent resource, also pick Give the agent work. Full access covers all of these.
- Copy the key. Crevio shows it only once.
- In n8n, create a Crevio API credential and paste the key into API Token. Leave API URL as it is.
n8n checks the token by calling Crevio's status endpoint when you save the credential.
Compatibility
Built with @n8n/node-cli 0.54 and tested on self-hosted n8n 2.45.4.
The Crevio Trigger needs n8n to be reachable from the internet over HTTPS, because Crevio only delivers webhooks to public HTTPS addresses. If n8n runs on your own computer, expose it with a tunnel (for example ngrok or Cloudflare Tunnel) and set n8n's WEBHOOK_URL environment variable to the tunnel address.
Usage
- IDs: Crevio IDs carry a prefix, such as
cus_for customers,prod_for products,ord_for orders andprice_for prices. Products can also be found by their slug. - Money: amounts are integers in the smallest currency unit, so
4900is $49.00. Currency codes are lowercase, such asusd. - Selling a product: create the product (it starts as a draft), add a price in Crevio, then update the product's status to Active. A product can't be active without a price.
- Payment links: Checkout → Create returns
purchase_url, a payment page you can send to a buyer. Prices come from a product'sprice_variants. - Metadata: customers, products and checkouts accept your own key-value pairs, such as the record ID in your CRM. Metadata on a checkout is copied to the order and comes back on
order.paid. - Paid orders and renewals:
order.paidalso fires for every subscription renewal. Checkbilling_reason:subscription_cycleis a renewal, anything else is a new purchase. - Test events: an event with
livemode: falsecame from a test purchase or a test delivery. Filter on it before acting on the outside world.
Example workflows
Welcome new buyers in your CRM
- Crevio Trigger on
order.paid. - IF
{{ $json.data.object.billing_reason }}is notsubscription_cycle. - Your CRM node creates or updates a contact from
{{ $json.data.object.customer.email }}. - Crevio → Customer → Add Tag, with Customer set to
{{ $('Crevio Trigger').item.json.data.object.customer.id }}and the tag ID of your "Onboarded" tag.
Send a payment link from a form
- Any form trigger (Typeform, Tally, n8n Form) collects an email address.
- Crevio → Checkout → Create with one line item (your price ID) and Email set from the form.
- An email node sends
{{ $json.purchase_url }}to the buyer.
Let an AI agent run the store
- Chat Trigger → AI Agent.
- Add Crevio as a tool of the AI Agent (operations such as Customer → Get Many, Order → Get Many and Discount → Create). The agent fills in the parameters itself.
- Ask "Create a 20% code SPRING20 for returning customers and tell me how many orders came in this week".
Weekly report from the Crevio agent
- Schedule Trigger every Monday.
- Crevio → Agent → Send Message: "Summarise last week's sales, new customers and refunds", with a Response Schema of
{ "type": "object", "properties": { "summary": { "type": "string" }, "revenue_cents": { "type": "integer" } } }. - A Slack node posts
{{ $json.json.summary }}.
Resources
- n8n community nodes documentation
- Crevio API documentation
- Crevio webhooks guide
- Crevio API conventions
Version history
0.1.0
First release: the Crevio node (10 resources, usable as an AI Agent tool) and the Crevio Trigger.