> ## 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.

# Join.me

## What's supported

### Supported actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL [https://api.join.me](https://api.join.me).

## Before You Get Started

To connect Join.me with Ampersand, you need [a Join.me Account](https://developer.join.me/).

Once your account is created, you'll need to create an app in Join.me and obtain the following credentials from your app:

* Key(Client ID)
* Secret(Client Secret)

You will then use these credentials to connect your application to Ampersand.

### Creating a Join.me App

Follow the steps below to create a Join.me app and add the Ampersand redirect URL.

1. Log in to your [Join.me](https://developer.join.me/login) account.

2. Once logged in, click on the **Login Credentials** link located in the upper-right corner of your Join.me account.

3. Click on the **Applications -> Create a New Application**

4. Enter Application Name in the **Name of the Application** section.

5. Enter website url in the **Web site** section and describe what the application do in the **Description** section.

6. Enter the Ampersand Callback URI: `https://api.withampersand.com/callbacks/v1/oauth` in the **Register Callback URL** section.

7. Agree the terms of service and then, Click the **Register Application**.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/joinMe_OAuth.gif?s=532d017271def6d201de31e1459c4ead" alt="Join.me OAuth Creation" width="800" height="450" data-path="images/provider-guides/joinMe_OAuth.gif" />

### Example integration

To define an integration for Join.me, create a manifest file that looks like this:

```YAML theme={null}
#amp.yaml
specVersion: 1.0.0
integrations: 
  - name: joinMeIntegration
    displayName: Join Me
    provider: joinMe
    proxy:
      enabled: true
```

## Add Your Join.me App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Join.me integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?fit=max&auto=format&n=Bx3tggG51e0liOp-&q=85&s=7ebd893fd2a976ebe7cf8af53f8581b8" alt="Ampersand Project Selection" width="2244" height="442" data-path="images/provider-guides/31a6a12-Ampersand.png" />

3. Select **Provider Apps**.

4. Select Join Me from the **Provider** list.

5. Enter the previously obtained Client ID in the **Client ID** field, the Client Secret in the **Client Secret** field and scopes in the **Scopes** field.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/joinMe.gif?s=4e585a3a370e3c5889baa8a7f6ab39b4" alt="Ampersand Integration" width="436" height="288" data-path="images/provider-guides/joinMe.gif" />
