Yammer Access Tokens

Access to the Yammer Managed Source requires the use of an OAuth 2.0 Access Token issued by Yammer.

How To Get A Yammer Access Token

If you use the DataSift dashboard you will never have to see the Access Token. DataSift will retrieve it and store it for you after you authenticate with Yammer when you create your Yammer Managed Source. There is nothing else to do.

When you want to use your Access Token with the DataSift Managed Sources API, you can create a Yammer Managed Source using the dashboard interface and retrieve the token using /source/get. Each Yammer source definition has an identities object and inside that object there is a parameters object with the value key, which stores the access credentials you are looking for.

Should you want to provide DataSift with a User Access Token that you generated yourself, you will need to obtain a time-unlimited Access Token. Yammer provides their own information about that process and there is more than one way of doing it.

This is one way to obtain a token:

  1. Set up a publicly-accessible server.

    You will need set up an HTTP server that can be reached from the public internet.

    You need a publicly-accessible HTTP server, because Yammer expects you to provide a redirect URL when you create an app that Yammer will generate your Access Token against.

    The server needs to run only when you want to obtain the Access Token, so a virtual server like an Amazon AWS EC2 micro instance running Linux is all you need.

  2. Ensure you have Python 2.7 or later installed.

    Run the following command to check if Python is installed on the server:

    $ python --version

    Check your system's documentation for guidance on installing and upgrading software packages if Python 2.7 or later is not available on your server.

  3. Install the Tornado HTTP server module.

  4. Copy mini-server.py to your new server.

  5. Start mini-server.py on the server.

    $ python mini-server.py

    This server does nothing useful beyond listening on port 8888 and replying to a request, but that is enough for our purposes.

    You do not have to use that particular server, but it important that the dummy HTTP server you will be using does not log requests as this could be a potential security risk.

  6. Test your server by sending a HTTP request to it.

    If your server has a publicly available IP address of, you need to point your browser at

    Make sure that port 8888 on your server is publicly accessible. You may need to adjust firewall settings.

    You are now ready to obtain an Access Token. But before you can do that, you need to create an app on Instagram.

  7. Log in to Yammer.

  8. Got to the Yammer developer site.

  9. Click on Create an App.

    Remember to provide the redirect URL to the dummy HTTP server, in this case

  10. Obtain an OAuth 2.0 code.

    Make a request to the /oauth2 endpoint. The request has to be made using a web browser, because you may be asked to log in to Yammer. For example, if your Client ID is 012345678901234 and the dummy HTTP server is listening for requests at on port 8888, the URL you need to type into your browser would be:


    The URL you will see in the browser will contain the code you need to make the second request.

  11. Get the Access Token.

    Make a request to the /oauth2 endpoint. The request can be made using a web browser or a command like curl. For example, if your app's Client ID is 012345678901234, the Client Secret is 0123456789abcdef, and the code you got in the previous step is abcdef0123456789 the URL you need to use would be:


    The JSON response you will get will contain access_token object and inside you will find the token field whose value is the Access Token you need to submit to DataSift.