diff --git a/README.md b/README.md
index 0407fce..0194211 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,19 @@
       :site => 'https://graph.facebook.com/v2.0',
       :authorize_url => "https://www.facebook.com/v2.0/dialog/oauth"
     }
+end
+```
+
+In API version 2.3 Facebook changed OAuth response format which is different from current omniauth-facebook default.  
+If you intend to use this or newer version (which might be a minimum allowed for your app!) you need to provide additional argument to `provider` as shown below.
+
+```ruby
+use OmniAuth::Builder do
+  provider :facebook, ENV['APP_ID'], ENV['APP_SECRET'],
+    :client_options => {
+      ...
+    },
+    token_params: { parse: :json }
 end
 ```
 ### Per-Request Options