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

# Invision Community

> Connect TerminalCAD with your community's Invision Community forum.

<Steps>
  <Step title="Create an IPS API key for TerminalCAD">
    TerminalCAD integrates with Invision Community directly using IPS' REST API. Each IPS4 community provides its own instance of the API. This means if you have multiple IPS communities, API keys are each issued separately.

    To create an IPS API key, first log into the [AdminCP](https://invisioncommunity.com/4guides/getting-started/first-login-r6/)

    1. Once you are logged into the AdminCP, head to **System** > **API**
           <img src="https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=a4a81e527c76c420aecf15172d663f62" alt="Screenshot of System > API" data-og-width="1754" width="1754" data-og-height="1098" height="1098" data-path="images/system-api.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=280&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=0c22c18164c975967630674ce5b07805 280w, https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=560&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=d9290d936fe4a44b368c88c048ff5b22 560w, https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=840&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=fa810be30a615d46f9b9c94e200a8cfc 840w, https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=1100&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=a8b51507c3e3ec1ca3f082acaa943243 1100w, https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=1650&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=fc12bd84af09fa841aaf2225e8c2e62d 1650w, https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/system-api.png?w=2500&fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=53ee1822d1f5ea5d214220d6a4dfcfa7 2500w" />

    2. Click on `REST API Keys`, then click `Create New`
           <img src="https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/rest-api-keys.png?fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=34544a20aa47fe965c64204bd3b2994e" alt="Screenshot of REST API Keys, then click Create New" width="1754" height="1098" data-path="images/rest-api-keys.png" />

    3. Once you do that, you'll be brought to a screen where you can create and limit what the API key can access. You can find the API key on the top of the page, and an input to name the API key. Additionally, you can select the API endpoints that we will have access to. We only require access to the following endpoints:

    * `GET` /core/groups
    * `GET` /core/members

    Then, remember to press `Save` at the bottom of the screen!

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/terminalcad/images/api-configuration.jpeg" alt="Screenshot of API creation configuration" />
  </Step>

  <Step title="Connect IPS with your TerminalCAD community">
    After you've create an IPS API key, you'll need to configure it for your TerminalCAD community.

    <Warning>Please note that **community owners** are the only people that can configure this in TerminalCAD.</Warning>

    1. Head over to your community admin panel > Third Party Integrations > Under Invision Community, click `Configure`.
    2. Enter your Community URL and IPS API key you created in Step 1 and click the `Save` button for each respective input.
           <img src="https://mintlify.s3.us-west-1.amazonaws.com/terminalcad/images/invision-demo.png" alt="Screenshot of interface to enter community url and API key" />

    Your community url is the domain in which IPS is hosted at. For example, if your IPS instance is hosted at [https://ips.example.com](https://ips.example.com). You would enter example.com for your community url. You can also find your community url under `System` > `API` > `REST API Reference`, as shown in the screenshot below.

    <img src="https://mintcdn.com/terminalcad/rdb0vV298NIBd6Sp/images/community-url.png?fit=max&auto=format&n=rdb0vV298NIBd6Sp&q=85&s=9c18cc6c194c040da34e3fb88c54cb55" alt="Screenshot of where to find community url" width="1754" height="1098" data-path="images/community-url.png" />
  </Step>

  <Step title="✅ Success">
    Great! You've successfully connected your IPS community with your TerminalCAD community. We're continuing to grow our offers for this direct integration, but we currently offer the following features:

    * Importing members of your community from your IPS community to your TerminalCAD community (***you must have permission from your community members to do this**, note that any abuse of this can result in you no longer being able this feature*)

    If you have any other suggestions for what you'd like to see in our Invision Community integration, feel free to suggest it on our [feedback board](https://app.terminalcad.io/feedback) (must be logged in).
  </Step>
</Steps>

If you need any assistance, reach out to the team at [support@terminalcad.io](mailto:support@terminalcad.io)!