Skip to content

Adding Discord, Figma and Freshbooks integrations to docs: Descriptions updated #151

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Adding Discord, Figma and Freshbooks integrations to docs: Descriptions updated #151

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
370b8ff
feat: discord docs added
bruce-bakshi-okta Oct 10, 2025
af09467
Merge branch 'main' into ulp-7212-forked
bruce-bakshi-okta Oct 14, 2025
39ea1e3
feat: Figma docs added
bruce-bakshi-okta Oct 14, 2025
7a8b771
Merge branch 'main' into ulp-7212-forked
bruce-bakshi-okta Oct 14, 2025
954cd3d
feat: freshbooks docs added
bruce-bakshi-okta Oct 14, 2025
d6f8aa4
feat: descriptions modified
bruce-bakshi-okta Oct 16, 2025
f04cf6e
Merge branch 'main' into ulp-7212-forked
bruce-bakshi-okta Oct 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 30 additions & 23 deletions auth4genai/integrations/discord.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,39 +1,46 @@
---
title: Discord
description: "Connect your AI Agents to Discord for server management, messaging, and community features."
---

import FindDomainInfoBlock from "/snippets/common/find-domain-info-block.mdx";
import AddConnectionInAuth0 from "/snippets/integrations/add-connection-auth0.mdx";
import LearnMore from "/snippets/integrations/learn-more.mdx";
import { IntegrationInfoBlock } from "/snippets/integrations/IntegrationInfoBlock.jsx";
import { Auth0SetupBlock } from "/snippets/integrations/Auth0SetupBlock.jsx";
import { TokenVaultConfigBlock } from "/snippets/integrations/TokenVaultConfigBlock.jsx";
import NextStepsBlock from "/snippets/integrations/next-step.mdx";

The Discord integration allows your AI Agents to authenticate users with their Discord accounts and access Discord servers, channels, and messaging features on their behalf.
A server moderation or utility agent (bot) that can welcome new members, play music, manage user roles, and integrate with other services to post notifications.

## Overview

The Discord integration is perfect for AI applications that need to interact with Discord communities, manage servers, send messages, or automate community workflows. This integration provides access to Discord's rich API for server and user management.

## Configuration
## Connect Discord to Auth0

<Steps>
<Step title="Set up app in Discord">

1. Sign up for a [Discord Developer account](https://discord.com/developers/applications)
<Step title="Discord setup">
1. Visit the [Discord Developer account](https://discord.com/developers/applications) page and sign up.
2. Create a new application in the Discord Developer Portal
3. Navigate to the OAuth2 section and note your **Client ID** and **Client Secret**

3. Navigate to the OAuth2 section and configure OAuth redirect URL:
- Redirect URL: `https://YOUR_AUTH0_DOMAIN/login/callback`
<FindDomainInfoBlock />
4. Note your **Client ID** and **Client Secret**
5. Set permissions/scopes you need:
- For basic login, the **identify** scope is generally required to get basic user information
6. Save changes

To learn more about setting up Discord, read the [Login with Discord documentation](https://discord.com/developers/docs/topics/oauth2).
</Step>
<Step title="Configure for Auth0">
<Step title="Auth0 setup">
<Auth0SetupBlock providerName="Discord" scopesName="Attributes" allowFreeFormScopes={true}/>
</Step>
</Steps>

1. Use the following settings when configuring your app:
- Homepage URL: `https://YOUR_AUTH0_DOMAIN`
- Authorization callback URL: `https://YOUR_AUTH0_DOMAIN/login/callback`
<IntegrationInfoBlock providerName="Discord" />

<FindDomainInfoBlock />
## Token Vault configuration example

</Step>
</Steps>
To configure the Token Vault for your Discord connection, you can use the following code snippet in your application:

<AddConnectionInAuth0 />
<TokenVaultConfigBlock
providerName="Discord"
connectionName="discord"
scopes={["identify"]}
/>

<LearnMore />
<NextStepsBlock />
55 changes: 31 additions & 24 deletions auth4genai/integrations/figma.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,39 +1,46 @@
---
title: Figma
description: "Connect your AI Agents to Figma for design collaboration, file management, and creative workflows."
---

import FindDomainInfoBlock from "/snippets/common/find-domain-info-block.mdx";
import AddConnectionInAuth0 from "/snippets/integrations/add-connection-auth0.mdx";
import LearnMore from "/snippets/integrations/learn-more.mdx";
import { IntegrationInfoBlock } from "/snippets/integrations/IntegrationInfoBlock.jsx";
import { Auth0SetupBlock } from "/snippets/integrations/Auth0SetupBlock.jsx";
import { TokenVaultConfigBlock } from "/snippets/integrations/TokenVaultConfigBlock.jsx";
import NextStepsBlock from "/snippets/integrations/next-step.mdx";

The Figma integration allows your AI Agents to authenticate users with their Figma accounts and access Figma files, projects, and design assets on their behalf.
A design workflow agent that can export assets, apply changes to design files programmatically, and comment on prototypes to automate design feedback loops.

## Overview

The Figma integration is perfect for design-focused AI applications that need to interact with design files, manage projects, collaborate on designs, or automate design workflows. This integration provides access to Figma's comprehensive API for design and collaboration features.

## Configuration
## Connect Figma to Auth0

<Steps>
<Step title="Set up app in Figma">

1. Sign up for a [Figma Developer account](https://www.figma.com/developers/api)
2. Create a new app in the Figma Developer Dashboard
3. Note your **Client ID** and **Client Secret**

<Step title="Figma setup">
1. Visit the [Figma Developer account](https://www.figma.com/developers/api) page and sign up.
2. Create a new app in the Figma Developer Dashboard.
3. Provide a name for your app and select a team or organization to associate it with.
4. Copy and securely store the **Client ID** and **Client Secret** that Figma provides.
5. Configure OAuth redirect URL:
- Redirect URL: `https://YOUR_AUTH0_DOMAIN/login/callback`
<FindDomainInfoBlock />
6. Select the necessary scopes that your application needs to access (current_user:read, file_content:read, file_comments:write, etc.).
7. Publish it.

To learn more about setting up Figma, read the [Login with Figma documentation](https://developers.figma.com/docs/rest-api/authentication/).
</Step>
<Step title="Configure for Auth0">
<Step title="Auth0 setup">
<Auth0SetupBlock providerName="Figma" scopesName="Attributes" allowFreeFormScopes={true} />
</Step>
</Steps>

1. Use the following settings when configuring your app:
- Website URL: `https://YOUR_AUTH0_DOMAIN`
- Authorization callback URL: `https://YOUR_AUTH0_DOMAIN/login/callback`
<IntegrationInfoBlock providerName="Figma" />

<FindDomainInfoBlock />
## Token Vault configuration example

</Step>
</Steps>
To configure the Token Vault for your Figma connection, you can use the following code snippet in your application:

<AddConnectionInAuth0 />
<TokenVaultConfigBlock
providerName="Figma"
connectionName="figma"
scopes={["current_user:read", "file_content:read", "file_comments:write"]}
/>

<LearnMore />
<NextStepsBlock />
54 changes: 31 additions & 23 deletions auth4genai/integrations/freshbooks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,41 +1,49 @@
---
title: Freshbooks
description: "Connect your AI Agents to Freshbooks for accounting, invoicing, and financial management."
---

import FindDomainInfoBlock from "/snippets/common/find-domain-info-block.mdx";
import AddConnectionInAuth0 from "/snippets/integrations/add-connection-auth0.mdx";
import LearnMore from "/snippets/integrations/learn-more.mdx";

The Freshbooks integration allows your AI Agents to authenticate users with their Freshbooks accounts and access accounting data, invoices, and financial information on their behalf.

## Overview
import FindDomainInfoBlock from "/snippets/common/find-domain-info-block.mdx";
import { IntegrationInfoBlock } from "/snippets/integrations/IntegrationInfoBlock.jsx";
import { Auth0SetupBlock } from "/snippets/integrations/Auth0SetupBlock.jsx";
import { TokenVaultConfigBlock } from "/snippets/integrations/TokenVaultConfigBlock.jsx";
import NextStepsBlock from "/snippets/integrations/next-step.mdx";

The Freshbooks integration is perfect for business and finance-focused AI applications that need to interact with accounting data, manage invoices, track expenses, or automate financial workflows. This integration provides access to Freshbooks' comprehensive API for accounting and business management.
An accounting agent for freelancers and small businesses that can create and send invoices, track expenses from receipts, and manage client information.

## Configuration
## Connect Freshbooks to Auth0

<Steps>
<Step title="Set up app in Freshbooks">
<Step title="Freshbooks setup">

1. Sign up for a [Freshbooks Developer account](https://www.freshbooks.com/developers)
1. Visit the [Freshbooks Developer account](https://www.freshbooks.com/developers) page and sign up.
2. Create a new app in the [Freshbooks Developer Center](https://my.freshbooks.com/#/developer)
3. Configure the app and add any scopes you may require
4. Navigate to your newly created app and scroll to the bottom of the "App Settings" tab.
5. Note your **Client ID** and **Client Secret**
3. Configure the app details:
- Set an Application Name.
- Set the Redirect URI: `https://YOUR_AUTH0_DOMAIN/login/callback`
- Note: FreshBooks requires HTTPS for redirect URIs (except for local development).
<FindDomainInfoBlock />
4. Select the necessary Scopes (e.g., user:profile:read, user:clients:read, user:invoices:read, etc.)
5. Save and copy the **Client ID** and **Client Secret**

To learn more about setting up Freshbooks, read the [Login with Freshbooks documentation](https://www.freshbooks.com/api/authentication).

</Step>
<Step title="Configure for Auth0">
<Step title="Auth0 setup">
<Auth0SetupBlock providerName="Freshbooks" scopesName="Attributes" allowFreeFormScopes={true} />
</Step>
</Steps>

1. Use the following settings when configuring your app:
- Website URL: `https://YOUR_AUTH0_DOMAIN`
- Redirect URI: `https://YOUR_AUTH0_DOMAIN/login/callback`
<IntegrationInfoBlock providerName="Freshbooks" />

<FindDomainInfoBlock />
## Token Vault configuration example

</Step>
</Steps>
To configure the Token Vault for your FreshBooks connection, you can use the following code snippet in your application:

<AddConnectionInAuth0 />
<TokenVaultConfigBlock
providerName="Freshbooks"
connectionName="freshbooks"
scopes={["user:profile:read", "user:clients:read", "user:invoices:read"]}
/>

<LearnMore />
<NextStepsBlock />