Troubleshoot common RCB Automation workflow issues
Diagnose and fix the most common problems in RCB Automation, from workflows that won’t run to webhooks that aren’t receiving data.
When something isn’t working as expected, the activity log is your best starting point. Every workflow run — including failures — is recorded there with full error details, timestamps, and payload data. Open Activity from the left sidebar before diving into the sections below.
Open the Activity log first. Most issues reveal themselves in the run history: you’ll see the exact step that failed, the error message returned, and the raw payload that was processed. This saves significant time before changing any configuration.
Workflows only execute when they are set to Active. A workflow in Draft or Paused status will not respond to triggers or run on a schedule.
1
Open the workflow
Navigate to Workflows in the left sidebar and click on the workflow you want to inspect.
2
Check the status badge
Look at the status indicator at the top of the workflow editor. It will show Active, Draft, or Paused.
3
Activate the workflow
If the workflow is not Active, click the Activate button in the top-right corner. Confirm the prompt if shown.
Workflows return to Draft status if you save changes while they are active. You must re-activate after editing.
Verify the trigger configuration
An incorrectly configured trigger is the most common reason a workflow does not run on time or doesn’t respond to an incoming event.
1
Open the trigger step
Click the trigger node (the first block) in your workflow to open its configuration panel.
2
For schedule triggers
Confirm the cron expression or schedule interval is correct. Check that the timezone is set to what you intended — a mismatch here causes runs to fire at unexpected times.
3
For webhook triggers
Copy the webhook URL shown in the trigger panel. Verify this exact URL is pasted into the sending service. Even a trailing slash difference will cause the request to miss.
4
Test the trigger
Use the Test trigger button to simulate an incoming event and confirm the workflow starts. For schedule triggers, use Run now to force an immediate execution.
Check for integration connection errors
If a connected integration has lost its authentication, workflows that depend on it will silently fail to start or stop mid-execution.
1
Go to the Integrations page
Navigate to Integrations in the left sidebar.
2
Look for error indicators
Any integration with a broken or expired connection will show a red warning badge. Click the integration to see the error detail.
3
Reconnect or re-authenticate
Click Reconnect and follow the OAuth flow, or paste a new API key if the integration uses key-based auth. Save your changes.
4
Re-run the workflow
After reconnecting, return to the workflow and click Run now to confirm it executes successfully.
Every failed run includes a detailed error log that identifies exactly which action failed and why. Reading it carefully resolves most issues without further investigation.
1
Open the Activity log
Click Activity in the left sidebar to see all recent runs.
2
Find the failed run
Runs with errors are marked with a red Failed badge. Click the run to open the run detail view.
3
Expand the failed step
Each step in the run is listed in order. Click the step that shows a failure icon to expand it. You’ll see the full error message, HTTP status code (if applicable), and the data that was sent.
4
Act on the error message
Use the error text to identify the cause. Common messages and their fixes are covered in the accordions below.
Expired credentials
If the error message mentions authentication failure, unauthorized access, or an invalid token, the credentials used by the action have expired or been revoked.
1
Identify the integration
Note which integration the failing action uses (for example, Slack, Google Sheets, or Salesforce).
2
Go to Integrations
Navigate to Integrations and locate that connection.
3
Reconnect
Click Reconnect to refresh the OAuth token, or click Edit to paste a new API key. Save your changes.
4
Retry the run
Return to the failed run in the Activity log and click Retry step to re-execute from the failed action without restarting the entire workflow.
Missing required fields
Actions that send data to external services (creating a record, sending a message, posting to an API) often require specific fields. If upstream steps don’t produce the expected data, the action fails with a validation error.
1
Check the error detail
Open the failed step in the run log. The error message will typically list the field name that is missing or invalid.
2
Trace the data source
In the workflow editor, open the failing action and inspect the field mappings. Confirm each required field is mapped to a data source that is guaranteed to produce a value.
3
Add a condition or fallback
If the upstream data is sometimes empty, add a Condition step before the action to check for the value, and route to a fallback path when it’s missing.
Dynamic field mappings that reference optional trigger fields (like a form field that users can leave blank) are a common cause of intermittent failures. Use a default value or add a condition to guard against empty inputs.
API rate limits from connected apps
When a workflow runs frequently or processes large batches, it may hit the rate limits of a connected service (such as sending too many emails per minute or making too many API requests per hour).
1
Identify the rate limit error
Look for HTTP 429 Too Many Requests responses in the run log, or error messages like “rate limit exceeded” or “quota exceeded.”
2
Add a delay step
Insert a Delay action between repeated calls to the same service. Even a 1–2 second delay can bring your request rate within the service’s limits.
3
Check the connected app's limits
Review the documentation for the connected service to understand their rate limit thresholds and reset windows.
4
Upgrade your plan if needed
Higher RCB Automation plans support priority execution queues that help manage high-throughput workflows. Contact support if rate limiting is a persistent issue.
Re-running a failed workflow step
You don’t need to restart an entire workflow from scratch when only one step fails. RCB Automation lets you retry from the point of failure.
1
Open the failed run
Go to Activity, find the failed run, and click to open it.
2
Locate the failed step
Scroll through the step list to find the step marked as failed.
3
Click Retry step
Click Retry step to re-execute that step using the same input data from the original run. The workflow continues from that point forward if the retry succeeds.
Retry step uses the original input data captured during the failed run. If the data itself was the problem, fix your trigger or upstream steps and run the workflow again from the beginning instead.
OAuth tokens for services like Google, Slack, and Microsoft expire periodically or are revoked when a password changes. Reconnecting takes less than a minute.
1
Navigate to Integrations
Click Integrations in the left sidebar.
2
Find the affected connection
Connections with expired tokens show a red badge or an “Authentication expired” warning. Click the connection.
3
Click Reconnect
Click the Reconnect button. You will be redirected to the connected service’s OAuth authorization page.
4
Authorize access
Sign in with the correct account and click Allow or Authorize. You’ll be redirected back to RCB Automation once the token is refreshed.
5
Verify the connection
The status badge should now show green. Any previously failing workflows will resume working on their next trigger.
Updating a rotated API key
If the connected service uses API key authentication and you’ve rotated the key, you need to update it in RCB Automation.
1
Copy the new API key
In the connected service, generate or copy the new API key. Keep this window open — you’ll need to paste it shortly.
2
Open the integration in RCB Automation
Go to Integrations, find the affected connection, and click Edit.
3
Paste the new key
Clear the existing key field and paste the new API key. Save the connection.
4
Test the connection
Click Test connection to confirm the new key is accepted by the service.
If the service supports multiple API keys simultaneously, generate the new key and update RCB Automation before revoking the old one. This prevents any downtime in your workflows during the rotation.
Checking permission scopes on the connected app
Some actions require specific permission scopes that may not have been granted when the connection was first authorized.
1
Read the error message
Open the failing run in the Activity log. Errors related to missing scopes typically say “insufficient permissions,” “access denied,” or reference a specific permission name.
2
Check required scopes
Review the integration’s documentation in RCB Automation (click the integration name to see its requirements) to find which scopes your action needs.
3
Re-authorize with expanded scopes
Go to Integrations, click the connection, and click Reconnect. During the OAuth flow, ensure the required permissions are checked. Some services require you to log in as an admin to grant certain scopes.
4
Check the connected app's settings
For API key integrations, go directly to the connected service and verify the API key has the necessary permissions or roles assigned.
A single character difference in the webhook URL means the sending service is posting to a different endpoint entirely.
1
Open the trigger configuration
Click the webhook trigger node in your workflow editor to open its configuration panel.
2
Copy the URL
Click the Copy button next to the webhook URL to copy it to your clipboard. Do not manually type or re-type the URL.
3
Paste into the sending service
Go to the sending service’s webhook settings and paste the URL directly. Replace any existing URL entirely — do not append or edit the existing one.
4
Send a test event
Use the sending service’s “Send test” or “Test webhook” feature. Then check the Activity log in RCB Automation to confirm the event was received.
Checking that the sending service uses POST
RCB Automation webhook triggers only accept HTTP POST requests. A GET request to your webhook URL will be ignored.
1
Check the sending service's method setting
In the sending service’s webhook configuration, look for an HTTP method setting. It must be set to POST.
2
Check the Content-Type header
Most integrations expect a Content-Type: application/json header. If the sending service sends application/x-www-form-urlencoded or multipart/form-data, the payload may not parse correctly.
3
Check the Activity log for received requests
Even malformed or incorrectly-typed requests will sometimes appear in the Activity log. Look for entries with unexpected status codes or empty payloads.
If the sending service only supports GET requests, you cannot use it as a webhook source. Consider using RCB Automation’s polling trigger (schedule + HTTP action) to fetch data from that service on a defined interval instead.
Inspecting the raw payload in the activity log
When a webhook fires but your workflow doesn’t behave as expected, inspecting the raw payload reveals what data was actually received versus what you expected.
1
Open the Activity log
Navigate to Activity and find the run triggered by the webhook event.
2
Click the trigger step
In the run detail view, click the trigger step to expand it. You’ll see the full raw payload exactly as it was received.
3
Compare with your field mappings
Check that the field names in the payload match the field references you’ve used in downstream steps. Field names are case-sensitive — userId and userid are different.
4
Adjust your workflow mappings
If the payload structure differs from what your workflow expects, update the field references in your action steps to match the actual payload structure.
RCB Automation executes workflows through a queue system. Under normal conditions, workflows start within a few seconds of being triggered. During periods of high platform load, there may be brief delays before your workflow begins.
1
Check the run timestamps
In the Activity log, compare the Triggered at time with the Started at time. A gap of more than 30 seconds during off-peak hours suggests a queue delay.
2
Check platform status
Visit the RCB Automation status page to see if there are any active incidents or elevated queue times affecting all customers.
3
Review workflow complexity
Workflows with many steps, large data transformations, or loops over large datasets take longer to complete. Break very large workflows into smaller sub-workflows where possible.
Scheduled workflows (cron triggers) are placed in the queue at their scheduled time. If the queue is busy, a scheduled workflow may start slightly after its scheduled time. This is expected behavior and does not indicate an error.
Upgrading for higher throughput
If your workflows consistently experience delays or you need to process high volumes of runs concurrently, upgrading your plan provides access to priority execution queues and higher concurrency limits.
1
Review your current usage
Go to Settings > Usage to see your current run volume, average queue time, and how close you are to your plan’s limits.
2
Compare available plans
Click Upgrade plan to see a comparison of throughput limits, concurrency settings, and execution priority across plans.
3
Contact support for enterprise needs
If you need custom throughput guarantees or dedicated execution infrastructure, contact support@rcbautomation.com to discuss enterprise options.