tellcasey
Integrations

n8n

Automate workflows with Casey using the n8n community node.

Connect Casey to hundreds of apps using n8n, an open-source workflow automation platform. The n8n-nodes-tellcasey community node lets you trigger workflows from conversation events, retrieve conversation data, and create short links — all without writing code.

Installation

The Casey node is available as a community node for self-hosted n8n instances.

  1. Open your n8n instance and go to Settings > Community Nodes.
  2. Enter n8n-nodes-tellcasey and click Install.
  3. The tellcasey and tellcasey Trigger nodes will appear in your node palette.

For more details, see the n8n community nodes documentation.

Community nodes are only supported on self-hosted n8n. They are not available on n8n Cloud.

Authentication

Both nodes require a Casey API key.

  1. In n8n, go to Credentials > New Credential and search for Casey API.
  2. Enter your API key (starts with sk_live_...). You can find it in the Casey dashboard under Settings > API Keys.
  3. Click Test to verify the connection, then Save.

Trigger node

The tellcasey Trigger node starts a workflow when a conversation event occurs. It registers a webhook with Casey automatically when you activate the workflow.

Events

EventDescription
conversation.startedA new conversation begins
conversation.completedA conversation finishes successfully
conversation.abandonedA conversation is abandoned (timeout, disconnect)

You can select one or more events per trigger node. The default is conversation.completed.

Example

A common pattern is to trigger a workflow when a conversation completes, then fetch the transcript and push it to a CRM or notification channel:

  1. Add a tellcasey Trigger node and select conversation.completed.
  2. Connect it to a tellcasey action node to fetch the transcript or assets.
  3. Send the results to Slack, HubSpot, Google Sheets, or any other n8n-supported app.

Action node

The tellcasey action node lets you interact with Casey's API. It supports three resources:

Create tracked short links that start conversations with pre-filled context.

Operation: Create

ParameterRequiredDescription
Connection CodeYesThe connection/invite code to link to (e.g., my-agent)
SlugNoCustom URL slug (auto-generated if omitted)
ContextNoJSON object with participant_profile and/or custom fields
Query ParamsNoAdditional query parameters appended to the redirect URL
Expires AtNoExpiration date for the short link

Context example:

{
  "participant_profile": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com"
  },
  "custom": {
    "deal_stage": "discovery",
    "account_id": "acc_123"
  }
}

Conversations

Retrieve conversation data, transcripts, and generated assets.

OperationDescription
GetRetrieve a single conversation by ID
ListList conversations with optional filters (status, agent, pagination)
Get TranscriptRetrieve the full message transcript
Get AssetsGet generated assets (summaries, reports, etc.)
Get Asset FieldsGet assets as flattened field/value pairs (useful for CRM integrations)

List filters:

FilterOptions
Statuspending, in_progress, completed, abandoned, archived, or all
Agent IDFilter by a specific agent UUID
Limit1-100 results (default 50)
AfterCursor for pagination

Assets

Retrieve generated content assets across your organization.

OperationDescription
ListList assets with optional filters (conversation, status, limit)
GetRetrieve a single asset with full content

List filters:

FilterOptions
Conversation IDFilter by conversation UUID
Statusdraft, generating, approved, published, archived, error, or all
Limit1-100 results (default 50)

AI agent tool use

Both the action and trigger nodes can be used as tools in n8n's AI agent workflows. This means you can give an AI agent access to Casey data — for example, letting it look up conversation transcripts or create personalized short links as part of a larger agentic flow.

Example workflows

Post conversation summary to Slack

  1. tellcasey Trigger (conversation.completed) ->
  2. tellcasey (Get Transcript, using conversation ID from trigger) ->
  3. Slack (Send message with transcript summary)

Sync assets to Google Sheets

  1. tellcasey Trigger (conversation.completed) ->
  2. tellcasey (Get Asset Fields, using conversation ID from trigger) ->
  3. Google Sheets (Append row with field values)
  1. Schedule Trigger (daily) ->
  2. HubSpot (Get new contacts) ->
  3. tellcasey (Create Short Link with contact context for each) ->
  4. HubSpot (Update contact with short link URL)

On this page