Contents x
    Discourse
    • 2 Minutes to read
    • Dark
      Light
    Contents

    Discourse

    • 2 Minutes to read
    • Dark
      Light
    Article summary

    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.

    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 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 button and select the connector from the list.
    2. From the drop-down menu, choose your authorizer.
      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.

    3. Name your data source and select your metrics and attributes.
    4. [Optional] Configure your advanced settings. If you are unsure about how to proceed, we recommend skipping this step.
    5. Configure your sync frequency or set the exact synchronization time under Show advanced settings.
      DATADDO TIP

      If you need to load historical data, refer to the Data Backfilling article.

    6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
    7. 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.
    • 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

    Sending Data to Data Storages

    Other Resources

    Was this article helpful?
    What's Next