Creating a Custom Connector

Step 1: Start from UCL Setup

• Go to the UCL Setup section in your Fastn project.

• Click “Add New App” to launch the App Builder Assistant chat.

Step 2: Create a Connector via Prompt

Type a natural language prompt like:

“Create a connector for Google Cloud Storage.”

The assistant may detect existing connector and ask where to add this app. For example:

Would you like to add the Google Cloud Storage connector under one of these, or shall I create a new group (e.g., “GoogleCloudStorage” with OAuth2 authentication)?

You respond:

“Create a new group.”

ℹ️ Want to add to an existing connector instead? Click “Add to Existing Connector” and select the connector you'd like to edit or extend with new actions.

Step 3: Confirm OAuth2 Authentication Setup

The assistant will suggest an OAuth2 setup for the new connector:

{
  "baseUrl": "https://accounts.google.com/o/oauth2/auth",
  "clientId": "",
  "secret": "",
  "params": {
    "scope": "https://www.googleapis.com/auth/devstorage.read_write",
    "response_type": "code",
    "access_type": "offline",
    "prompt": "consent"
  },
  "requiredAttributes": [],
  "tenantId": "default",
  "authorization": {
    "oauthGrantType": "authCodeGrantWithGrantType",
    "accessTokenUrl": "https://oauth2.googleapis.com/token",
    "refreshTokenGrantType": "refreshTokenWithAccessType"
  }
}

Confirm when prompted:

“Yes.”

The assistant will respond:

“The ‘GoogleCloudStorage’ group is ready.”

Step 4: Add Actions to the Connector

The assistant will suggest actions to expose:

Which GCS operation would you like to expose first as a connector? For example:

• listBuckets

• getBucketMetadata

• createBucket

• deleteBucket

• listObjects

• uploadObject

• downloadObject

• deleteObject

You can respond:

“Add createBucket and listObjects.”

You’ll then receive:

The connectors “createBucket” and “listObjects” have been created successfully in the “GoogleCloudStorage” group. You can now use them in your workflows.

Step 5: Finalize Setup in the Connectors Section

• Navigate to the Connectors section in your Fastn project.

• Under Workspace Connectors, find the newly created GoogleCloudStorage group.

• Click the three dots menu > Edit, and fill in the clientId and secret using your Google Cloud credentials.

• Save the configuration.

Step 6: Connect and Test with AI Agent

• Now go back to the Setup section.

• Search for your GoogleCloudStorage connector group and connect the app by authenticating your Google account.

• Once connected, select any of the added actions (like createBucket or listObjects).

• Use the AI Agent to test your connector with a natural command:

  “Create a bucket in my Google Cloud Storage.”

Additional Prompt Ideas for creating Custom Connector

• “Create a connector for a fitness tracking app like Strava.”

• “Build a connector that pulls ticket data from our in-house Jira instance.”

• “Set up a custom connector for a REST API with POST and GET methods.”