Skip to main content

Company churn check

Runs a churn analysis for the company you are viewing and returns a risk score with a suggested next action. This is the on-demand version of Churn risk alerts: same scoring, but for one company at the moment you ask.

Runs: Embedded in Propeller · Trigger: Button · Difficulty: Easy

What you need​

  • An n8n account. See Set up n8n.
  • A Propeller API key.
  • Owner access on the Configuration role to create the agent.

How it works​

When you run the agent on a company page, the workflow looks up the company and compares its last 30 days of orders with the 60 days before. Three signals make up a score from 0 to 100: ordering less often, spending less per order and staying quiet longer than the usual ordering gap.

The reply shows the risk level (low, medium or high), what changed and a suggested action. A high risk suggests a call or visit, a medium risk a check-in message. If the company has too little order history, the agent says so instead of guessing.

Install it​

  1. In n8n, import the downloaded JSON as a new workflow.
  2. On the Webhook node, set a basic auth credential (a username and password you choose) and copy the production URL.
  3. Create a header auth credential with your Propeller API key and select it on the HTTP Request nodes.
  4. Activate the workflow.
  5. Go to Admin > Agents and create an agent with Trigger Button and Interaction Mode Single Turn. Under Types, pick SALES_HUB_COMPANY. Paste the webhook URL and the same basic auth values. See AI Agents.
  6. Open a company, click the Workflows button and run the agent to test it.
Filling in your API key

In n8n, create a credential of type Header Auth and fill in its two fields exactly like this:

FieldWhat to fill in
NameapiKey
ValueYour Propeller API key

Name is not a title you pick yourself. It has to say exactly apiKey, otherwise the workflow cannot sign in. See Set up n8n for the full steps.

Placement matters

An agent type is the page where the agent appears. Stick to the types listed in the install steps: the workflow depends on the data that page sends along, so placing the agent on other pages may not work.

Make it yours​

  • Sensitivity: the signal weights and the risk thresholds live in the Score & Format node.
  • Windows: change RECENT_DAYS and BASELINE_DAYS in the Resolve Company node.
  • Suggested actions: edit the texts in the Score & Format node.

Use it outside n8n​

Copy the JSON into an AI assistant and follow Adjust a workflow with an AI assistant.

Good to know

The workflows and agents in the Agent Hub are free to use and adapt. They are examples, not supported product features, so test them in a staging environment and check the results before using them in production.