{"_id":"582f7ad4d6c87c270029ddd1","category":{"_id":"582f7ff88ea0800f0035639a","version":"556cd8aec14029190092d295","__v":0,"project":"556cd8aec14029190092d292","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-18T22:26:00.021Z","from_sync":false,"order":2,"slug":"reverb-app-store","title":"Reverb App Store"},"user":"556cbb50c14029190092d20f","__v":0,"parentDoc":null,"project":"556cd8aec14029190092d292","version":{"_id":"556cd8aec14029190092d295","__v":14,"project":"556cd8aec14029190092d292","createdAt":"2015-06-01T22:11:58.756Z","releaseDate":"2015-06-01T22:11:58.756Z","categories":["556cd8afc14029190092d296","55ca5a55241e790d004f47ea","55dc9fdb4f535537007da1b2","55dc9fdfc755b63700dc843c","55fdb08c4bebdf17004130d4","560ef4c2a36c610d00e7013e","5613db296a092921004c30c2","56156581dc8aea0d002475e8","56169d1ee98f5517005627a8","5622fde7de7dc01700c6dd5f","56cf75f3336aa60b0086a495","5818f3c02093901b00bcf91a","582f7ff88ea0800f0035639a","583f30c110448a2500dd990f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-18T22:04:04.172Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Welcome! This is a tutorial to get started building Reverb Apps!\n\n## What are Reverb Apps?\n\nBroadly speaking, a Reverb App is any product that integrates with the Reverb API. More specifically, apps come in 3 flavors:\n\n1. [Embedded Apps sold on Reverb App Store](https://dev.reverb.com/docs/reverb-apps-embedded-vs-external#section-embedded-apps) - These run within the Reverb UI and appear a seamless part of the Reverb experience to users. You build an app and host it at yoursite.com. Reverb displays your app in an iFrame. \n2. [External Apps sold on Reverb App Store](https://dev.reverb.com/docs/reverb-apps-embedded-vs-external#section-external-apps) - These are apps run on your website (yoursite.com) but still sold and promoted through the Reverb App store.\n3. [E-commerce Integrations](https://reverb.com/apps#integrations) - These apps use the Reverb API but are typically implemented inside of other platforms and sold through other app stores. For example, our Shopify, Bigcommerce, and Magento integrations are external apps. The payments are handled through external app stores. To get your E-Commerce integration promoted at reverb, please [contact us at integrations:::at:::reverb.com](mailto:integrations@reverb.com).\n\nBoth Embedded and External Apps are sold through the [Reverb App Store](https://reverb.com/apps) by charging users directly (as line items on their monthly statement). Developers don't have to worry about dealing with payments as the Reverb App Store will automatically charge users a monthly fee (set by the Developer) after a 30 day trial. Developers are paid 80% of the App's earnings.\n\n## How do I build an app?\n\nHere are your basic steps:\n1. Create your app in any platform or language you like. The only requirement is that it's a web application that can be served in a web browser.\n2. Get [Sandbox Access](doc:sandbox) to test your app.\n3. [Create the production version of your app](https://reverb.com/apps/new)\n4. Decide whether your app will be served embedded or standalone by clicking the checkbox on the form when creating your page.\n5. Integrate [authentication](doc:how-should-i-authenticate) into your app. If your app is going to be performing actions or pulling data for a particular user, you will have to implement an OAuth Flow: [Apps for multiple users (OAuth2 Access Code Flow)](doc:build-a-multi-user-app-with-oauth) \n6. When your app first loads, if the user is not logged in, you should immediately start an OAuth flow by [redirecting them to Reverb](https://dev.reverb.com/docs/build-a-multi-user-app-with-oauth#1-redirect-users-to-reverb-to-request-access) - this way the first screen they see is a Reverb Permissions screen that allows them to install the app.\n7. Once the user is authenticated, you may store the token and use it to perform other requests with the API.\n\n## Where are some example apps?\n\nCheck out [the Reverb App Store](https://reverb.com/apps) to see some examples. There are a handful of apps built by Reverb.com that are good examples. \n\n## Additional Resources\n* [Learn more about Embedded and External Apps](doc:reverb-apps-embedded-vs-external) \n* [Build an E-Commerce Sync Integration](doc:build-an-e-commerce-sync-integration) \n* [Interactive API Reference (Swagger)](doc:swagger) \n* [Client Libraries](doc:sample-code-and-client-libraries) \n* [Support Forum](https://dev.reverb.com/discuss)","excerpt":"","slug":"build-your-first-reverb-app","type":"basic","title":"Build your first Reverb App"}

Build your first Reverb App


Welcome! This is a tutorial to get started building Reverb Apps! ## What are Reverb Apps? Broadly speaking, a Reverb App is any product that integrates with the Reverb API. More specifically, apps come in 3 flavors: 1. [Embedded Apps sold on Reverb App Store](https://dev.reverb.com/docs/reverb-apps-embedded-vs-external#section-embedded-apps) - These run within the Reverb UI and appear a seamless part of the Reverb experience to users. You build an app and host it at yoursite.com. Reverb displays your app in an iFrame. 2. [External Apps sold on Reverb App Store](https://dev.reverb.com/docs/reverb-apps-embedded-vs-external#section-external-apps) - These are apps run on your website (yoursite.com) but still sold and promoted through the Reverb App store. 3. [E-commerce Integrations](https://reverb.com/apps#integrations) - These apps use the Reverb API but are typically implemented inside of other platforms and sold through other app stores. For example, our Shopify, Bigcommerce, and Magento integrations are external apps. The payments are handled through external app stores. To get your E-Commerce integration promoted at reverb, please [contact us at integrations@reverb.com](mailto:integrations@reverb.com). Both Embedded and External Apps are sold through the [Reverb App Store](https://reverb.com/apps) by charging users directly (as line items on their monthly statement). Developers don't have to worry about dealing with payments as the Reverb App Store will automatically charge users a monthly fee (set by the Developer) after a 30 day trial. Developers are paid 80% of the App's earnings. ## How do I build an app? Here are your basic steps: 1. Create your app in any platform or language you like. The only requirement is that it's a web application that can be served in a web browser. 2. Get [Sandbox Access](doc:sandbox) to test your app. 3. [Create the production version of your app](https://reverb.com/apps/new) 4. Decide whether your app will be served embedded or standalone by clicking the checkbox on the form when creating your page. 5. Integrate [authentication](doc:how-should-i-authenticate) into your app. If your app is going to be performing actions or pulling data for a particular user, you will have to implement an OAuth Flow: [Apps for multiple users (OAuth2 Access Code Flow)](doc:build-a-multi-user-app-with-oauth) 6. When your app first loads, if the user is not logged in, you should immediately start an OAuth flow by [redirecting them to Reverb](https://dev.reverb.com/docs/build-a-multi-user-app-with-oauth#1-redirect-users-to-reverb-to-request-access) - this way the first screen they see is a Reverb Permissions screen that allows them to install the app. 7. Once the user is authenticated, you may store the token and use it to perform other requests with the API. ## Where are some example apps? Check out [the Reverb App Store](https://reverb.com/apps) to see some examples. There are a handful of apps built by Reverb.com that are good examples. ## Additional Resources * [Learn more about Embedded and External Apps](doc:reverb-apps-embedded-vs-external) * [Build an E-Commerce Sync Integration](doc:build-an-e-commerce-sync-integration) * [Interactive API Reference (Swagger)](doc:swagger) * [Client Libraries](doc:sample-code-and-client-libraries) * [Support Forum](https://dev.reverb.com/discuss)