Send events, query data, and build integrations with the Prody REST API. 121 endpoints across 15 categories.
https://app.prody.com
REST · JSON
Get your API key from Settings → Setup Guide, then send a test event:
Check the Home page — your event appears instantly. All endpoints require x-api-key in the request header.
Send tracking events. Record logins, page views, and custom events.
| Parameter | Type | Description |
|---|---|---|
event_type | string (required) | Event name (e.g. "login", "page_view") |
user_email | string | User email. If omitted, anonymous ID generated. |
account_id | string | Account identifier for B2B. |
page_url | string | Required for page_view events. |
properties | object | JSON properties attached to the event. |
external_id | string | External ID for third-party matching. |
Merge anonymous user with identified user. Reassigns all historical events.
| Parameter | Type | Description |
|---|---|---|
anonymous_id | string (required) | Anonymous ID to merge from. |
user_email | string (required) | Identified email to merge into. |
Record client-side errors as page_error events.
| Parameter | Type | Description |
|---|---|---|
page_url | string (required) | Page where error occurred. |
error_type | string (required) | js_error, api_error, not_found, network_error, other. |
error_message | string | Error message (max 500 chars). |
status_code | integer | HTTP status code. |
List all accounts with usage stats. Supports global filters.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days (default 30). |
segment_id | int | Filter to segment. |
industry | string | Filter by industry. |
company_size | string | Filter by size. |
owner_email | string | Filter by CS owner. |
Detailed account info: summary stats, users, properties, owner, external ID.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Update firmographic properties (industry, company_size, segment, revenue_range).
| Parameter | Type | Description |
|---|---|---|
properties | object | Properties to set. |
Assign CS owner.
| Parameter | Type | Description |
|---|---|---|
owner_email | string (required) | Owner email. |
Top 10 users by activity for this account.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Daily activity trend (users + events) for one account.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Health score history with signal change events.
Add a note to an account.
| Parameter | Type | Description |
|---|---|---|
content | string (required) | Note text. |
Delete an account note.
Accounts with declining activity vs prior period.
| Parameter | Type | Description |
|---|---|---|
days | int | Comparison period (default 30). |
Per-account usage for specified features.
| Parameter | Type | Description |
|---|---|---|
features | string (required) | Comma-separated event types. |
days | int | Look back N days. |
Distinct values for each firmographic field. Used for filter dropdowns.
User detail with event history, account, and properties.
| Parameter | Type | Description |
|---|---|---|
events_limit | int | Max events (default 100, max 500). |
Update user attributes (first_name, last_name, external_id, custom properties).
| Parameter | Type | Description |
|---|---|---|
properties | object | Attributes to set. |
List notes for a user.
Add a note to a user.
| Parameter | Type | Description |
|---|---|---|
content | string (required) | Note text. |
Delete a user note.
Daily activity trend for one user.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Top 10 users by event count. Supports global filters.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Daily breakdown of new vs returning users.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Monthly unique user counts.
All event types with counts. Default 90-day window.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Property keys and sample values for an event type.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Flexible query with include/exclude conditions and property filters.
| Parameter | Type | Description |
|---|---|---|
includes | array | Event conditions to include (up to 4). |
excludes | array | Event conditions to exclude. |
days | int | Look back N days. |
Correlation: users who do X are Nx more likely to do Y.
| Parameter | Type | Description |
|---|---|---|
event_a | string | First event. |
event_b | string | Second event. |
All tracked pages with view counts.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Daily active users and total events. Supports global filters.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Users active in last 5 minutes with sparkline.
Session-based path analysis with drop-off points.
| Parameter | Type | Description |
|---|---|---|
event | string (required) | Starting event. |
depth | int | Steps (default 4). |
direction | string | "forward" or "backward". |
Sequential funnel with step-to-step conversion.
| Parameter | Type | Description |
|---|---|---|
steps | string (required) | Comma-separated events. |
days | int | Look back N days. |
Same funnel across different segments.
| Parameter | Type | Description |
|---|---|---|
steps | string | Comma-separated events. |
segments | string | Comma-separated segment IDs. |
Cohort-based retention analysis.
| Parameter | Type | Description |
|---|---|---|
event_a | string (required) | Cohort entry event. |
event_b | string (required) | Return event. |
period | string | "week" or "month". |
Feature adoption rates for all event types.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Detailed adoption for one feature with daily trend.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Compare up to 4 features side by side.
| Parameter | Type | Description |
|---|---|---|
features | string | Comma-separated events. |
Daily trend for an event with optional property breakdown.
| Parameter | Type | Description |
|---|---|---|
event | string (required) | Event type. |
group_by | string | Property key to group by. |
List all segments.
| Parameter | Type | Description |
|---|---|---|
search | string | Search by name/rule/event. |
folder | string | Filter by folder. |
Create a segment with combinable rules.
| Parameter | Type | Description |
|---|---|---|
name | string (required) | Segment name. |
rules | array (required) | Rule objects (event_count, did_event, etc). |
folder | string | Folder name. |
segment_type | string | "dynamic" or "static". |
Segment detail with resolved user list.
Update segment name, rules, or folder.
Delete a segment.
Estimate segment size before saving.
| Parameter | Type | Description |
|---|---|---|
rules | array | Same format as create. |
Compare two segments: overlap and behavioral diff.
| Parameter | Type | Description |
|---|---|---|
a | int | First segment ID. |
b | int | Second segment ID. |
List all segment folders.
Create a folder.
| Parameter | Type | Description |
|---|---|---|
name | string | Folder name. |
Paginated signals feed.
| Parameter | Type | Description |
|---|---|---|
page | int | Page (default 1). |
severity | string | critical, warning, info. |
category | string | success, product, journey. |
days | int | Last N days. |
Summary stats with category counts.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Prioritized daily focus list.
| Parameter | Type | Description |
|---|---|---|
limit | int | Max items (default 10). |
Record an action taken. Starts Impact tracking.
| Parameter | Type | Description |
|---|---|---|
action_type | string (required) | What was done. |
Dismiss a signal.
5-component account health scores (Activity, Breadth, Depth, Trend, Recency).
| Parameter | Type | Description |
|---|---|---|
status | string | green, yellow, red. |
sort | string | score, status, trend. |
Health score detail for a specific account.
Closed-loop overview: actions taken, outcomes, headline ROI stats.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days (default 90). |
Actions with outcomes (pending, resolved, unresolved).
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
status | string | Filter by outcome. |
page | int | Page number. |
Manually resolve or unresolve an action.
| Parameter | Type | Description |
|---|---|---|
resolved | boolean | true = resolved. |
CSV export of all actions with outcomes.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Natural language query to Ask Prody. Returns AI analysis backed by your data.
| Parameter | Type | Description |
|---|---|---|
message | string (required) | Your question. |
chat_id | string | Continue a conversation. |
Behavioral patterns predicting success.
| Parameter | Type | Description |
|---|---|---|
status | string | new, reviewed, actioned, dismissed, all. |
min_lift | number | Minimum lift (e.g. 2.0 for 2x). |
limit | number | Max results. |
Summary: total active, new, highest lift, pinned count.
Update status or pin state.
| Parameter | Type | Description |
|---|---|---|
status | string | new, reviewed, actioned, dismissed. |
pinned | boolean | Pin to top. |
List configured success events for discovery analysis.
Add a success event (max 3).
| Parameter | Type | Description |
|---|---|---|
event_type | string (required) | Success event. |
time_window_days | number | Window in days. |
Remove a success event definition.
List all journeys with latest metrics and recommendation counts.
Journey detail with 30 days of snapshots and AI recommendations.
Live funnel computation (not from nightly snapshot).
Users stuck between two journey steps.
Create a journey (2-8 steps). Plan limits apply.
| Parameter | Type | Description |
|---|---|---|
name | string (required) | Journey name. |
steps | array (required) | [{event_type, label}]. |
completion_window_days | number | Days to complete (default 7). |
Update name, steps, window, or status. Admin only.
Delete journey, snapshots, and recommendations.
Act on a recommendation. Logs to Impact tracking.
Dismiss a recommendation.
List all nudges with stats and audience info.
Single nudge with full config, stats, and target users.
Create a nudge.
| Parameter | Type | Description |
|---|---|---|
title | string (required) | Nudge title. |
target_page_url | string (required) | Page to show it on. |
nudge_type | string | "floating" or "banner". |
body | string | Message body. |
button_text | string | CTA text. |
target_segment_id | int | Segment to target. |
Update nudge config. Recalculates audience_type.
Activate. Returns conflict warnings for same-page nudges.
Pause. Auto-resolves linked recovery signals.
Delete nudge and audience log.
Track impression/click/dismiss from tracker.js.
| Parameter | Type | Description |
|---|---|---|
event_type | string | "impression", "click", "dismiss". |
user_email | string | User for attribution. |
AI generates nudge copy from journey context.
| Parameter | Type | Description |
|---|---|---|
journey_id | int | Journey ID. |
step_index | int | Step. |
Audience flow: entered, shown, clicked, dismissed, progressed.
Aggregate nudge impact for Results page.
| Parameter | Type | Description |
|---|---|---|
days | int | Look back N days. |
Trigger dynamic audience refresh. Admin only.
List all products the user has access to.
Create a new isolated product.
| Parameter | Type | Description |
|---|---|---|
name | string (required) | Product name. |
Rename a product.
| Parameter | Type | Description |
|---|---|---|
name | string | New name. |
Delete a product. Cannot delete active product.
Switch active product. Re-issues session.
| Parameter | Type | Description |
|---|---|---|
tenant_id | int (required) | Product ID. |
Monthly tracked users across all products with daily breakdown.
Data stats: total events, users, accounts, event types.
Set data retention policy.
| Parameter | Type | Description |
|---|---|---|
retention_days | int | Days to retain (0 = unlimited). |
Bulk delete events by type or date.
| Parameter | Type | Description |
|---|---|---|
event_type | string | Delete events of this type. |
before_date | string | Delete before this date. |
Rename event type across all events.
| Parameter | Type | Description |
|---|---|---|
old_name | string | Current name. |
new_name | string | New name. |
Merge two event types.
| Parameter | Type | Description |
|---|---|---|
source | string | Merge from. |
target | string | Merge into. |
Archive or restore event type.
| Parameter | Type | Description |
|---|---|---|
event_type | string | Event type. |
archived | boolean | true/false. |
List properties for an event type.
| Parameter | Type | Description |
|---|---|---|
event_type | string | Scope to type. |
Rename a property key.
| Parameter | Type | Description |
|---|---|---|
event_type | string | Scoped type. |
old_key | string | Current key. |
new_key | string | New key. |
Merge two property keys.
| Parameter | Type | Description |
|---|---|---|
source | string | Merge from. |
target | string | Merge into. |
Property metadata (status, description).
| Parameter | Type | Description |
|---|---|---|
event_type | string | Scope to type. |
Update property metadata.
| Parameter | Type | Description |
|---|---|---|
property_key | string | Key. |
status | string | verified, hidden, default. |
description | string | Description. |
All PII data for a user (DSAR compliance).
Anonymize user: replace email with hash, clear properties.
| Parameter | Type | Description |
|---|---|---|
email | string | User email. |
Export all user data as CSV.
| Parameter | Type | Description |
|---|---|---|
email | string | User email. |
Bulk update account metadata.
| Parameter | Type | Description |
|---|---|---|
updates | array | [{account_id, fields}]. |
Import account metadata from CSV (5K row limit).
Bulk update user metadata.
| Parameter | Type | Description |
|---|---|---|
updates | array | [{email, fields}]. |
Import user metadata from CSV (5K row limit).
Get tenant settings.
Update settings. Admin only.
| Parameter | Type | Description |
|---|---|---|
auto_derive_accounts | boolean | Derive accounts from email domain. |
product_mode | string | "b2b" or "employee". |
company_name | string | Company name. |
Get custom event labels.
Save custom labels.
| Parameter | Type | Description |
|---|---|---|
labels | object | Map: event_type to label. |
List all threshold alerts.
Create a threshold alert.
| Parameter | Type | Description |
|---|---|---|
name | string | Alert name. |
metric | string | event_count, active_users, etc. |
threshold | number | Value. |
direction | string | "above" or "below". |
List goals with progress.
Create a measurable goal.
| Parameter | Type | Description |
|---|---|---|
name | string | Goal name. |
target | number | Target value. |
metric | string | Metric to track. |
List saved views.
| Parameter | Type | Description |
|---|---|---|
page | string | Page identifier. |
Export data as CSV.
| Parameter | Type | Description |
|---|---|---|
type | string | users, accounts, events, feature_adoption. |
days | int | Look back N days. |
segment_id | int | Filter to segment. |
| Endpoint | Limit | Window |
|---|---|---|
/ingest | 500 requests | 1 minute |
/api/* | 100 requests | 1 minute |
/auth/* | 10 requests | 15 minutes |
/api/prody | 100,000 tokens | 24 hours |
Exceeding limits returns 429 with a Retry-After header.