diff --git a/OAuth-details.md b/OAuth-details.md
new file mode 100644
index 0000000..8e63b89
--- /dev/null
+++ b/OAuth-details.md
@@ -0,0 +1,9 @@
+We use the [Doorkeeper gem for OAuth](https://github.com/doorkeeper-gem/doorkeeper/wiki), so you can refer to their docs on specifics of the end-points.
+
+The API is divided up into access scopes:
+
+- `read`: Read data
+- `write`: Post statuses and upload media for statuses
+- `follow`: Follow, unfollow, block, unblock
+
+Multiple scopes can be requested during the authorization phase with the `scope` query param (space-separate the scopes).
\ No newline at end of file