# Create a Discourse API key

Last updated Sep 23rd, 2026

Common Room’s Discourse integration requires an API key to import Contacts and Activity.

## Setup

Connect a Discourse API to Common Room

# Connect a Discourse API to Common Room

## An Interactive Guide

Get Started

1/10

1. **Open the Discourse API settings** from the Admin menu.
2. **Click New API key**, and enter in the following information.
   1. Description: Common Room
   2. User Level: Single user
   3. User: your username (must have admin privileges)
   4. Scope: Global

You can use either a **global** or a **non-global** API key with our integration. We recommend using a **global** key, which works with all Discourse setups and allows imports to run the fastest, especially for larger communities.

3. **Copy your API key and click continue**

### **How to create a non-global key**

A non-global key works with _most_ Discourse setups and requires reduced permissions, but cannot import data as quickly as with a global key. You can use a non-global key with reduced permissions with Common Room as long as your Discourse instance does not have the **login required** setting enabled.

To use a non-global key:

1. Verify that **login required** is disabled

2. Follow the steps above to create an API key, but leave **Global Key** unchecked (or in some Discourse versions, select **Granular** in the **Scope** dropdown) and instead select the following scopes:
   1. Topics ⇒ read
   2. Topics ⇒ read lists
   3. Users ⇒ show
   4. Users ⇒ check emails

### Related Docs

- [Discourse Integration Guide](/content/docs/signals/community-and-social-integrations/discourse/index.html)
- [Create a Discourse webhook](/content/docs/signals/community-and-social-integrations/discourse/create-a-discourse-webhook/index.html)

### Related Playbooks

- [Automatically identify and track economic buyers](/content/playbooks/automatically-identify-and-track-economic-buyers/index.html)
- [Send real-time purchase intent alerts to your GTM team](/content/playbooks/get-buyer-intent-alerts-to-sellers/index.html)
- [Find the best cities for your event strategy](/content/playbooks/find-best-cities-for-in-person-events/index.html)

### Fresh playbooks

- [**Auto-deliver prospect intel to reps with an AI agent**](/content/playbooks/auto-deliver-prospect-intel-to-reps-with-an-ai-agent/index.html)

- [**Prospect at the perfect time with signal trends**](/content/playbooks/prospect-at-the-perfect-time-with-signal-trends/index.html)

- [**Enrich and action on prospects directly from SFDC and HubSpot**](/content/playbooks/enrich-and-action-on-prospects-directly-from-sfdc-and-hubspot/index.html)

### We use tracking to better understand our visitors. [Read more.](/content/privacy-policy/index.html)