--- title: "Discourse" slug: "discourse" description: "Utilize Discourse to create engaging, well-organized forums and leverage Dataddo for seamless data integration and analytics across all your platforms." updated: 2024-04-30T09:17:38Z published: 2024-04-30T09:17:38Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt > Use this file to discover all available pages before exploring further. # Discourse **Discourse** is an open-source software platform designed for community discussion, enabling users to host forums and build modern, civilized spaces for conversation online. It offers robust features for moderation, organization, and interaction among members, making it ideal for everything from small groups to large-scale public communities. Refer to Discourse's official documentation to see [all available endpoints from the Discourse API](https://docs.discourse.org/). ## Authorize Connection to Discourse ### In Discourse To authorize your Discourse account, you will need your **domain name**, **username**, **an API token)**. 1. In your Discourse account, navigate to the **Admin** page, scroll down to **Advanced** and select **API keys**. 2. Click on **New API Key**. 3. Fill in the new API key's description, select a specific user or all users, and assign permissions scopes. 4. Copy the **API Key** value and keep it safe as you can display it only once. ### In Dataddo 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select Discourse. 2. Fill in the following fields: 1. **Host**: The domain where a Discourse forum is installed. 2. **Username**: Your Discourse username. 3. **API Token**: Discourse API key. 3. Rename your ***authorizer*** for easier identification and click on **Save**. ## How to Create a Discourse Data Source 1. On the **Sources** page, click on the [**Create Source**](https://app.dataddo.com/sources/new) button. 2. Select the connector from the list and name your ***data source***. 3. On the **Dataset** step, select your **dataset**. **DATADDO TIP** If you're unsure which dataset to select, use the search bar to look for datasets with the desired attributes or metrics. 4. On the **Account** step select your ***authorizer*** from the drop-down menu. **Didn't find your authorizer?** Click on **Add new Account** at the bottom of the drop-down and follow the on-screen prompts. You can also go to the **Authorizers** tab and click on [**Add New Service**](https://app.dataddo.com/service/new). 5. On the **Attributes and Metrics** step, select the **metrics and attributes** you want to extract. ![Create a source using a custom-schema connector.](https://cdn.document360.io/084ed225-3f99-4644-a2da-39ca0cd5ef45/Images/Documentation/Create%20Source%20-%20Custom-Schema%20Connector.png) 6. On the **Metadata** step, select which [**metadata fields**](/docs/metadata-inclusion) such as extraction time to add to your data. 7. On the **Snapshot** step: 1. Configure your [**sync frequency**](/docs/extraction#extraction-frequency) or click **Show advanced settings** to set the exact synchronization time. **DATADDO TIP** If you need to **load historical data**, refer to the [**Data Backfilling**](https://docs.dataddo.com/docs/data-backfilling) article. 2. [Optional] Enable the **Allow Empty Data Extractions** toggle to allow the extraction when no data is available. 8. In the top-right corner, click **Test Data** button to preview extracted data. You can **adjust the date range** for a specific time frame. 9. Click on **Save** and **congratulations, your new data source is ready!** --- ## Troubleshooting ### Data Preview Unavailable No data preview when you click on **Test Data** might be caused by an issue with your ***source*** configuration. The most common causes are: - **Date range**: Try a smaller date range. You can load the rest of your data afterward using [manual data load](https://docs.dataddo.com/docs/data-backfilling). - **Insufficient permissions**: Please make sure your authorized account has at least admin-level permissions. - **Invalid metrics, attributes, or breakdowns**: You may not have any data for the selected metrics, attributes, or breakdowns. - **Incompatible combination of metrics, attributes, or breakdowns**: Your selected combination cannot be queried together. Please refer to the service's documentation to view a full list of metrics that can be included in the same ***data source***. ## Related Articles Now that you have successfully created a ***data source***, see how you can connect your data to a dashboarding app or a data storage. **Sending Data to Dashboarding Apps** - [Simple Data Integration to Dashboards](https://docs.dataddo.com/docs/simple-data-integration-to-dashboards) - [Data Backfilling to Dashboarding Apps](https://docs.dataddo.com/docs/data-backfilling-to-dashboarding-apps) **Sending Data to Data Storages** - [Batch Ingestion to Data Warehouses](https://docs.dataddo.com/docs/ingestion-to-data-warehouses) - [Data Backfilling to Storages](https://docs.dataddo.com/docs/data-backfilling-to-storages) **Other Resources** - [Troubleshooting](https://docs.dataddo.com/docs/troubleshooting) - [Extraction Logs](https://docs.dataddo.com/docs/extraction-logs) - [Data Duplication](https://docs.dataddo.com/docs/data-duplication) An API token is a code snippet used to secure API access. It's sent to API servers as identification, confirming whether the user or application has access, and provides both authentication and user/application information to the API server. Authorizers act as credentials for external services (e.g. Facebook or Google). To enable Dataddo to access and retrieve your data, you need to grant access to accounts that possess admin-level permissions or higher within these services.