diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aba569d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# Active Collab API
+
+> Note: I have tested this API against the Cloud-Hosted version of [Active-Collab](https://activecollab.com/), not with the self-hosted installation!
+
+## Useful links
+
+* https://developers.activecollab.com/api-documentation/index.html
+* https://github.com/activecollab/activecollab-feather-sdk
+* https://stackoverflow.com/questions/tagged/activecollab
+
+## Workflow
+
+1. Login with username and password to Authentication Server and get back the `intent` for the user 
+2. Request a token for an Account using the Account `url` and the users `intent`
+3. Use the token to authenticate for every other API-Call
+
+Example login:
+
+```python
+auth = ACAuthenticator()
+session = auth.login(username, password)
+pprint(session)
+user = session['user']
+# use first account
+account = auth.find_account(account_name)
+```
+
+Example request token
+
+```python
+token = ACTokenAuthenticator(account, user).issue_token_intent()
+pprint(token)
+```
+
+Example client request
+
+```python
+ac = ACClient(account, token)
+res = ac.get_projects()
+pprint(res.json())
+```
+
+## Configuration
+
+config.ini:
+
+```ini
+[LOGIN]
+username = you@example.com
+password = very-secret
+account_name = "#123456"
+```