{"_id":"546b9214b47b5d1400109efa","version":{"_id":"545137a814af501a00b50cfc","project":"545137a814af501a00b50cf9","__v":11,"createdAt":"2014-10-29T18:53:28.525Z","releaseDate":"2014-10-29T18:53:28.525Z","categories":["545137a814af501a00b50cfd","545138eaa66f020800dbab4a","546b9072b47b5d1400109edf","546b9082b47b5d1400109ee0","546b9088b47b5d1400109ee1","546b909462515a14007ebc43","546b90a0b47b5d1400109ee2","546ced235884600e007a92f6","5481008eea7fd40b00cd7c2b","573b9d83ee2b3b220042291f","57be1efa15efc70e006a5f99"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"user":"5433099f9a2b451a00ad4531","parentDoc":null,"project":"545137a814af501a00b50cf9","__v":36,"category":{"_id":"545137a814af501a00b50cfd","project":"545137a814af501a00b50cf9","version":"545137a814af501a00b50cfc","pages":["545137a814af501a00b50cff","5451389e14af501a00b50d11","5451384514af501a00b50d04","546b8edb62515a14007ebc39","546b9214b47b5d1400109efa","546b922862515a14007ebc4f","546b9234b47b5d1400109efc","546b924762515a14007ebc51","546b925662515a14007ebc53","546fdac1691dc8080089521d","547374bd007eb108007e0380"],"__v":11,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-29T18:53:28.598Z","from_sync":false,"order":0,"slug":"documentation","title":"Documentation"},"updates":["561435a0fe362d0d0025d708","58ed753a16dff20f0046cb38"],"next":{"pages":[],"description":""},"createdAt":"2014-11-18T18:38:12.673Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","try":true,"basic_auth":false,"auth":"never","params":[],"url":""},"isReference":false,"order":1,"body":"**Register An App With Yammer**\n\nGo to https://www.yammer.com/client_applications. Click on the “Register new App” button. Please note, when you create an app, this app will be linked to the Yammer network related to your user account. This is the network you will use to access, edit, and test your application.\n\nConsider using a service account when registering your app at https://www.yammer.com/client_applications. i.e. “apps:::at:::yourcompany.com” - This will ensure your app continues to work if you or the app creator leaves the company.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/brg0HMtRCazCfGqKxlX4_1-Reg-app.png\",\n        \"1-Reg-app.png\",\n        \"1006\",\n        \"351\",\n        \"#b69554\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Register a New App - Required Fields:\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Application Name:\",\n    \"1-0\": \"Organization:\",\n    \"2-0\": \"Support e-mail:\",\n    \"3-0\": \"Website:\",\n    \"4-0\": \"[Terms of Use](https://msdn.microsoft.com/en-us/mt790174.aspx/)\",\n    \"0-1\": \"The app name which will appear in Yammer’s activity stream.\",\n    \"1-1\": \"The name of the organization affiliated with your app.\",\n    \"2-1\": \"An email address, which users of your app can contact for support.\",\n    \"3-1\": \"Your organization’s website.\",\n    \"4-1\": \"Yammer API Terms of Use.\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5WnVsKVeQAMLzj9nKl3j_2-Reg-Screenshot-300x284.png\",\n        \"2-Reg-Screenshot-300x284.png\",\n        \"300\",\n        \"284\",\n        \"#486f94\",\n        \"\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Basic Info\"\n}\n[/block]\nOnce you have registered your app, fill-in the basic information.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": []\n    }\n  ]\n}\n[/block]\n**Redirect URI**\nAfter the authentication flow is complete, this is where Yammer will redirect the user. To ensure that your redirect will succeed, ensure that the following criteria are met:\n\n1) The scheme of the provided URI must match the scheme of the app's URI. This means that query parameters should be sent as query_params attached at the end of the URL, not as part of the path.\n2) The host must match. \n3) The path must match\n4) The redirect URI must be secure (i.e., if the scheme is http, it must be using https). See https://developer.yammer.com/docs/oauth-2 for more details. All apps **must** redirect to https services.\n\nFor static urls, use the full url, without the leading www. For example:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://user.dynamics.com\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nFor dynamic url subdomains, such as https://<instancename>.dynamics.com, use only the domain name. For instance:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://dynamics.com\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n\n\n**JavaScript Origins**\nIf you intend to use Yammer's JavaScript SDK, you need to register all the domains that you will use with the SDK. Each domain should be entered in the ***Javascript Origins*** box followed by a new line. Each domain should be in the format scheme://domain. The schemes must be either http or https e.g http://domain.com or https://secure.domain.com. Whenever possible, it is recommended to register domains that support SSL/TLS encryption\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/eI9bd2hRSqer3mqDKTq9_Screen%20Shot%202015-02-05%20at%2010.54.48%20AM.png\",\n        \"Screen Shot 2015-02-05 at 10.54.48 AM.png\",\n        \"1412\",\n        \"1238\",\n        \"#1d4d3b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"app-registration","type":"basic","title":"Step 1: App Registration"}

Step 1: App Registration


**Register An App With Yammer** Go to https://www.yammer.com/client_applications. Click on the “Register new App” button. Please note, when you create an app, this app will be linked to the Yammer network related to your user account. This is the network you will use to access, edit, and test your application. Consider using a service account when registering your app at https://www.yammer.com/client_applications. i.e. “apps@yourcompany.com” - This will ensure your app continues to work if you or the app creator leaves the company. [block:image] { "images": [ { "image": [ "https://files.readme.io/brg0HMtRCazCfGqKxlX4_1-Reg-app.png", "1-Reg-app.png", "1006", "351", "#b69554", "" ] } ] } [/block] [block:parameters] { "data": { "h-0": "Register a New App - Required Fields:", "h-1": "Description", "0-0": "Application Name:", "1-0": "Organization:", "2-0": "Support e-mail:", "3-0": "Website:", "4-0": "[Terms of Use](https://msdn.microsoft.com/en-us/mt790174.aspx/)", "0-1": "The app name which will appear in Yammer’s activity stream.", "1-1": "The name of the organization affiliated with your app.", "2-1": "An email address, which users of your app can contact for support.", "3-1": "Your organization’s website.", "4-1": "Yammer API Terms of Use." }, "cols": 2, "rows": 5 } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/5WnVsKVeQAMLzj9nKl3j_2-Reg-Screenshot-300x284.png", "2-Reg-Screenshot-300x284.png", "300", "284", "#486f94", "" ], "caption": "" } ] } [/block] [block:api-header] { "type": "basic", "title": "Basic Info" } [/block] Once you have registered your app, fill-in the basic information. [block:image] { "images": [ { "image": [] } ] } [/block] **Redirect URI** After the authentication flow is complete, this is where Yammer will redirect the user. To ensure that your redirect will succeed, ensure that the following criteria are met: 1) The scheme of the provided URI must match the scheme of the app's URI. This means that query parameters should be sent as query_params attached at the end of the URL, not as part of the path. 2) The host must match. 3) The path must match 4) The redirect URI must be secure (i.e., if the scheme is http, it must be using https). See https://developer.yammer.com/docs/oauth-2 for more details. All apps **must** redirect to https services. For static urls, use the full url, without the leading www. For example: [block:code] { "codes": [ { "code": "https://user.dynamics.com", "language": "text" } ] } [/block] For dynamic url subdomains, such as https://<instancename>.dynamics.com, use only the domain name. For instance: [block:code] { "codes": [ { "code": "https://dynamics.com", "language": "text" } ] } [/block] **JavaScript Origins** If you intend to use Yammer's JavaScript SDK, you need to register all the domains that you will use with the SDK. Each domain should be entered in the ***Javascript Origins*** box followed by a new line. Each domain should be in the format scheme://domain. The schemes must be either http or https e.g http://domain.com or https://secure.domain.com. Whenever possible, it is recommended to register domains that support SSL/TLS encryption [block:image] { "images": [ { "image": [ "https://files.readme.io/eI9bd2hRSqer3mqDKTq9_Screen%20Shot%202015-02-05%20at%2010.54.48%20AM.png", "Screen Shot 2015-02-05 at 10.54.48 AM.png", "1412", "1238", "#1d4d3b", "" ] } ] } [/block]