How to push Crisp profile events

Learn how to push user events to Crisp from your website, backend, or workflows.

Events are useful when you want Crisp to react to product or customer actions, such as signup, purchase, upgrade, or cancellation. They can help trigger campaigns, feed workflows, or give your team more context about what a user just did.

Push an event with the JavaScript SDK

Use the Crisp JavaScript SDK after the Crisp chatbox snippet is available on the page.

// Replace the event name, data, and color with your own values.
$crisp.push(["set", "session:event", [[
  ["product_bought", { price: "$200", name: "iPhone 6S" }, "red"]
]]]);

A session event includes an event name, an optional data object, and an optional color. Supported colors are red, orange, yellow, green, blue, purple, pink, brown, grey, and black.

Replace product_bought with your own event, such as login, signup, upgrade, or order_completed.

You can also push events from your backend. Read How to push user events from my backend for that setup.

Push an event from a workflow

You can also push an event from a workflow using the Push Session Event action block.

Push Session Event action block in a Crisp workflow

This can be useful when you want to:

Trigger a campaign after a customer asks for product information
Send a meeting link after a workflow collects enough qualification details
Track a workflow outcome so your team can reuse the event later

Use events safely

Events are best for automation and timeline context. They should not be used as a permanent database.

Crisp only retains the most recent events for users. If you need to store stable per-user information, use custom data instead.

Want to know more about the $crisp interface? Read How do I use the $crisp chatbox SDK?.

Updated on: 03/05/2026

Was this article helpful?

Thank you!