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.
- Open your n8n instance and go to Settings > Community Nodes.
- Enter
n8n-nodes-tellcaseyand click Install. - 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.
- In n8n, go to Credentials > New Credential and search for Casey API.
- Enter your API key (starts with
sk_live_...). You can find it in the Casey dashboard under Settings > API Keys. - 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
| Event | Description |
|---|---|
conversation.started | A new conversation begins |
conversation.completed | A conversation finishes successfully |
conversation.abandoned | A 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:
- Add a tellcasey Trigger node and select
conversation.completed. - Connect it to a tellcasey action node to fetch the transcript or assets.
- 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:
Short Links
Create tracked short links that start conversations with pre-filled context.
Operation: Create
| Parameter | Required | Description |
|---|---|---|
| Connection Code | Yes | The connection/invite code to link to (e.g., my-agent) |
| Slug | No | Custom URL slug (auto-generated if omitted) |
| Context | No | JSON object with participant_profile and/or custom fields |
| Query Params | No | Additional query parameters appended to the redirect URL |
| Expires At | No | Expiration 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.
| Operation | Description |
|---|---|
| Get | Retrieve a single conversation by ID |
| List | List conversations with optional filters (status, agent, pagination) |
| Get Transcript | Retrieve the full message transcript |
| Get Assets | Get generated assets (summaries, reports, etc.) |
| Get Asset Fields | Get assets as flattened field/value pairs (useful for CRM integrations) |
List filters:
| Filter | Options |
|---|---|
| Status | pending, in_progress, completed, abandoned, archived, or all |
| Agent ID | Filter by a specific agent UUID |
| Limit | 1-100 results (default 50) |
| After | Cursor for pagination |
Assets
Retrieve generated content assets across your organization.
| Operation | Description |
|---|---|
| List | List assets with optional filters (conversation, status, limit) |
| Get | Retrieve a single asset with full content |
List filters:
| Filter | Options |
|---|---|
| Conversation ID | Filter by conversation UUID |
| Status | draft, generating, approved, published, archived, error, or all |
| Limit | 1-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
- tellcasey Trigger (conversation.completed) ->
- tellcasey (Get Transcript, using conversation ID from trigger) ->
- Slack (Send message with transcript summary)
Sync assets to Google Sheets
- tellcasey Trigger (conversation.completed) ->
- tellcasey (Get Asset Fields, using conversation ID from trigger) ->
- Google Sheets (Append row with field values)
Create personalized outreach links
- Schedule Trigger (daily) ->
- HubSpot (Get new contacts) ->
- tellcasey (Create Short Link with contact context for each) ->
- HubSpot (Update contact with short link URL)