> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discourse

## What's supported

### Supported actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://{{.workspace}}`, where `workspace` is your Discourse-hosted domain.

### Example integration

To define an integration for Discourse, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: discourse-integration
    displayName: My Discourse Integration
    provider: discourse
    proxy:
      enabled: true
```

## Using the connector

This connector uses API Key auth along with an API Username, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)

<Note>
  The API Username is currently set to `system` for everyone. Please use `system` as the username when configuring your integration. For more information, see the [Discourse API documentation](https://docs.discourse.org/).
</Note>

To start integrating with Discourse:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for an API key.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the API key and API Username supplied by the customer. Please note that this connector's base URL is `https://{{.workspace}}`.

## Creating an API key for Discourse

[Click here](https://docs.discourse.org/) for more information about generating an API key for Discourse.