Troubleshooting: Common Workflow Errors and Solutions

Your workflow stopped working? Here is how to fix it.

When a workflow fails, check:

1. Is the trigger firing - Check trigger logs. Did the event actually happen.
2. Are integrations connected - Check integration status (green equals connected). Are credentials still valid.
3. Did the action fail - Check action logs. What was the error message.

Error: Integration Not Connected

What it means: Octacer cannot reach the connected service.

Reasons: API key expired, service is temporarily down, internet connection issue, permissions were revoked.

Fix:

1. Go to Integrations
2. Find the disconnected service
3. Click Reconnect
4. Re-authenticate
5. Test connection
6. Restart workflow

Time to fix: 2-5 minutes

Error: Required Field Missing

What it means: The action expects data that is not provided.

Example: Error - Required field email is missing

Reasons: Previous step did not extract the field, field name is misspelled, data is not in the expected format.

Fix:

1. Check previous step output
2. Verify field name matches exactly
3. Add a condition to handle missing data

Time to fix: 5-10 minutes

Error: Invalid Data Format

What it means: Data does not match expected format.

Examples: email must be in format user at domain.com, phone must be 10 digits, date must be YYYY-MM-DD

Fix:

1. Identify expected format
2. Add transformation before sending
3. Test with sample data
4. Deploy

Time to fix: 10-15 minutes

Error: Rate Limit Exceeded

What it means: Too many requests sent too quickly.

Error message: 429 Too Many Requests

Fix Option 1: Add Delays - After each action, add 1-second delay
Fix Option 2: Batch Processing - Batch into groups of 100 instead of processing individually
Fix Option 3: Implement Backoff - Request fails with 429, wait 10 seconds, retry

Time to fix: 15-30 minutes

Error: Connection Timeout

What it means: Workflow waited too long for response.

Error message: Timeout after 30 seconds waiting for response

Reasons: External service is slow, network latency is high, service is having issues.

Fix:

1. Is the service down - Check status page
2. Try again (often temporary)
3. Increase timeout setting if available
4. Optimize the request

Time to fix: 5-10 minutes

Error: Authentication Failed

What it means: Credentials are invalid or expired.

Error message: 401 Unauthorized or Invalid API key

Reasons: API key was rotated, user revoked access, permissions changed, password was changed.

Fix:

1. Get fresh API key from service
2. Go to Integrations and service
3. Update API key
4. Test connection
5. Restart workflow

Time to fix: 5-10 minutes

Error: Field Mapping Error

What it means: Cannot map data from source to destination.

Example: Cannot map customer_id to customerId

Fix:

1. Check destination field names exactly
2. If field name is different, map explicitly
3. If data type is different, convert data
4. If field does not exist, contact service support

Time to fix: 10-15 minutes

1. 1

   Identify Failure

   Check workflow logs. What was the last successful run. What changed since then.

2. 2

   Check Integrations

   Are all integrations connected. All green equals continue. Any red equals reconnect and retry.

3. 3

   Review Logs

   Click on failed run. What step failed. What was the error message. What input data was used.

4. 4

   Test Steps

   Go to workflow editor. Run trigger manually. Check that first step produces expected output. Continue through each step.

5. 5

   Review Data

   Is the data correct. Are all required fields present. Is format correct. Are values in expected range.

6. 6

   Check Integrations

   Are credentials valid. API keys expired. Permissions revoked. Password changed.

7. 7

   Make One Change

   Change only ONE thing. Test. Document result. If success - done. If failure - revert and try different change.

8. 8

   Get Help

   If stuck check Knowledge Base, ask in community, contact support with workflow name, error message, when it started failing, and what you have already tried.

Daily: Monitor error rate. Check for any warnings.
Weekly: Review workflow runs. Check integration status. Verify credentials are still valid.
Monthly: Review performance metrics. Look for patterns in errors. Update documentation.
Quarterly: API provider changes. Any deprecation warnings. Compliance requirements changed.

Contact support@octacer.com when:

• Error message is unclear
• You have tried the above and still stuck
• Issue is with Octacer itself (not external service)
• You need custom integration help

Include: Workflow name, full error message, screenshot of error, what you have already tried, when it last worked.