Where to Find It
Open any flow in the Flow Builder and click the “Execution Logs” tab at the top of the page.What the Logs Show
The Execution Logs tab displays a chronological list of every action that has fired in this flow. Each log entry contains:Fan Name and Email
Who the action was executed for. Click the fan name to open their full profile.Action Type
What kind of action was executed:- Email — A Send Email action fired
- SMS — A Send SMS action fired
- Instagram DM — A Send Instagram DM action fired
- Delay — A delay completed (time delay, fan-action delay, or until-date)
- Condition — A condition was evaluated
- Tag/Update — A fan profile was updated
- Add to List — A fan was added to a list
- Invite to Extra — A fan was invited to an Extra
- Go to Flow — A fan was redirected to another flow
Timestamp
The exact date and time the action executed, displayed in your account timezone. Hover for the full timestamp with seconds.Status
Every log entry has one of three statuses:Success (Green)
The action executed correctly. The email was delivered, the SMS was sent, the condition was evaluated, the delay completed.Failed (Red)
The action encountered an error and did not complete. The log entry includes an error message explaining what went wrong.Pending (Yellow)
The action is scheduled but has not executed yet. This typically appears for delayed actions that are queued for future delivery.Error Message (Failed Actions Only)
When an action fails, the log entry includes a specific error message:- “SMS delivery failed: Fan does not have SMS opt-in” — The fan has not opted in to SMS. The message was not sent.
- “Instagram DM failed: 24-hour messaging window expired” — The fan’s last Instagram interaction was more than 24 hours ago.
- “Email delivery failed: Email address bounced” — The fan’s email address is invalid or no longer active.
- “Email delivery failed: Unsubscribed” — The fan unsubscribed from emails.
- “Condition evaluation failed: Missing fan data” — The condition references a fan attribute that does not exist for this fan.
- “Go-to-Flow failed: Target flow not found” — The target flow was deleted or deactivated.
- “SMS delivery failed: No provisioned phone number” — Your account does not have a Telnyx number set up.
Details
Each log entry includes contextual details specific to the action type:- Email: Subject line of the email sent
- SMS: The text message content
- Instagram DM: The DM message content
- Delay: Duration of the delay and whether it completed naturally or timed out
- Condition: The condition that was evaluated and the result (Yes or No)
- Tag/Update: Which tag was added/removed or which field was updated
- Go to Flow: Which flow the fan was redirected to
Search
Use the search bar to filter logs by:- Fan name: Find all actions executed for a specific fan
- Fan email: Search by email address
- Action type: Type “email,” “sms,” “condition,” etc. to filter by action type
Filters
Filter by Action Type
Narrow the logs to show only specific action types:- All: Every action (default)
- Email: Only Send Email actions
- SMS: Only Send SMS actions
- Instagram DM: Only Send Instagram DM actions
- Delay: Only completed delays
- Condition: Only condition evaluations
- Tag/Update: Only profile updates
- Go to Flow: Only flow redirections
Date Range Filter
Filter logs by when they occurred:- Last 24 hours: Today’s activity
- Last 7 days: This week
- Last 14 days: Two-week window
- Last 30 days: Monthly view
- Custom range: Pick specific start and end dates
Expandable Entries
Click any log entry to expand it and see the complete execution history for that specific fan — every action in chronological order, not just the one you clicked. The expanded view shows the fan’s full journey through the flow:- Trigger event and enrollment timestamp
- Every delay, action, and condition in order
- Which branch the fan took at each condition
- Success/failure status for each step
- Error messages for any failed steps
Debugging Common Issues
”A fan says they never received the email”
- Search for the fan by name or email
- Find the Send Email log entry
- Check the status:
- Success: The email was sent. Check the fan’s spam folder or confirm their email address is correct.
- Failed: Read the error message. Common causes: email bounced, fan unsubscribed.
- Not found: The fan may not have reached the email action yet. Expand their row to see where they are in the flow.
”The flow seems to be stalling”
- Filter by action type: Delay
- Look for delays with unusually long durations
- Check if fans are stuck on fan-action delays waiting for an action they are unlikely to take
- Consider adjusting the timeout duration on those delays
”Fans are taking the wrong branch”
- Filter by action type: Condition
- Look at the condition results (Yes/No) for multiple fans
- If most fans are going down the wrong branch, the condition logic may be misconfigured
- Click a specific condition entry to see what data was evaluated
”SMS messages are not being delivered”
- Filter by action type: SMS
- Filter by status: Look for failed entries
- Common causes:
- No SMS opt-in: The fan has not opted in. This is the most common cause.
- Invalid phone number: The fan’s phone number is missing or malformed.
- No provisioned number: Your Telnyx number is not set up or has been disconnected.
- Rate limit: If you are using a local number (2 msg/min), messages may be queued and delayed.
”Instagram DMs are failing”
- Filter by action type: Instagram DM
- Read the error messages:
- “24-hour messaging window expired”: The fan’s last interaction was too long ago. Shorten delays before IG DM actions.
- “Fan Instagram handle not found”: Fanaura does not have the fan’s Instagram username. This fan entered via a non-Instagram trigger.
- “Instagram API rate limit”: Too many DMs sent too quickly. This resolves on its own.
”A condition is always returning No”
- Search for the condition in the logs
- Expand several fan entries to see what data the condition evaluated
- Common causes:
- The fan attribute being checked does not exist for most fans
- The comparison value is wrong (e.g., checking for “gold” when the actual value is “Gold” — case sensitivity)
- The condition checks behavior from a previous flow that fans have not been through
Log Retention
Execution logs are retained for the lifetime of the flow. As long as the flow exists, its logs are available. Deleted flows (in the 30-day recovery window) retain their logs until permanent deletion. For very active flows with thousands of fans, the date range filter and search tools keep the logs manageable.Tips and Best Practices
- Check logs within the first hour: After activating a flow, review the execution logs to make sure the first batch of fans is processing correctly
- Filter by “Failed” first: When investigating issues, start with failed actions — they have the error messages you need
- Use expandable rows: Individual log entries are useful, but the expanded per-fan view tells the complete story
- Compare expected vs actual: If a fan should have received 3 emails but the logs show only 1, something went wrong between actions 1 and 3
- Export for analysis: If you notice patterns in failures, document them and adjust your flow logic accordingly
- Monitor after edits: If you edit an active flow, check the logs afterward to make sure the changes did not break anything for fans already in progress