diff --git a/docs/reference/04-error-handling.md b/docs/reference/04-error-handling.md
new file mode 100644
index 0000000..aef0671
--- /dev/null
+++ b/docs/reference/04-error-handling.md
@@ -0,0 +1,5 @@
+## Error handling
+
+Most of the errors fired by the API are handled by the API itself. It triggers a `CartoError` every time an error happens.
+
+A cartoError is an object containing a single `message` field with a string explaining the error.