Error codes
Refer to the following table for commonly-encountered errors in Marco API and how to troubleshoot them.
Code | Description | Troubleshooting |
400 | Input Error. Check the request payload for issues. | Cause: The request is not formatted properly. Solution: Check your request payload, headers, and parameters for accuracy, and cross-reference with the API Reference. |
403 | Access denied. Additional privileges are needed access the requested resource. | Cause: The caller does not have authorized access to the resource. Solution: Ensure that your API caller account has admin access. For more information, refer to Authorization. |
404 | Not Found. The requested resource does not exist. | Cause: The resource does not exist. Solution: Check that the resource ID is correct and try again. |
429 | Rate Limited. Too many requests. | Cause: Too many requests have been sent in a short amount of time. Solution: Use bulk endpoints where possible, and otherwise retry with exponential backoff. |
500 | Unexpected error. | Cause: The server is experiencing issues. Solution: Retry after a brief moment, and contact Marco Payroll if the issue persists. |