Instagram
=========

Backend class
-------------

For Django, add this class path to ``AUTHENTICATION_BACKENDS``. For other
integrations, use the same class path in the framework-specific backend
setting.

.. list-table::
   :header-rows: 1

   * - Backend name
     - Class path
   * - ``instagram``
     - ``social_core.backends.instagram.InstagramOAuth2``

Instagram uses OAuth v2 for Authentication.

- Register a new application at the `Instagram API`_, and

- Add instagram backend to ``AUTHENTICATION_SETTINGS``::

      AUTHENTICATION_SETTINGS = (
        ...
        'social_core.backends.instagram.InstagramOAuth2',
        ...
      )

- fill ``Client Id`` and ``Client Secret`` values in the settings::

      SOCIAL_AUTH_INSTAGRAM_KEY = ''
      SOCIAL_AUTH_INSTAGRAM_SECRET = ''

- extra scopes can be defined by using::

    SOCIAL_AUTH_INSTAGRAM_AUTH_EXTRA_ARGUMENTS = {'scope': 'likes comments relationships'}

.. _Instagram API: http://instagr.am/developer/