Skip to content

Conversation

@ian-at-airbyte
Copy link
Contributor

@ian-at-airbyte ian-at-airbyte commented Jan 29, 2026

What

Tutorial for bringing your own OAuth flow. Supports https://github.com/airbytehq/sonar/pull/2056. Companion to https://github.com/airbytehq/sonar/pull/2157.

How

Adds a straightforward HubSpot tutorial explaining how to use Oauth.

Review guide

User Impact

Can this PR be safely reverted and rolled back?

  • YES 💚
  • NO ❌

@github-actions
Copy link
Contributor

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

  • 🛠️ Quick Fixes
    • /format-fix - Fixes most formatting issues.
    • /bump-version - Bumps connector versions, scraping changelog description from the PR title.
  • ❇️ AI Testing and Review:
    • /ai-docs-review - Provides AI-powered documentation recommendations for PRs with connector changes.
    • /ai-prove-fix - Runs prerelease readiness checks, including testing against customer connections.
    • /ai-canary-prerelease - Rolls out prerelease to 5-10 connections for canary testing.
    • /ai-review - AI-powered PR review for connector safety and quality gates.
  • 🚀 Connector Releases:
    • /publish-connectors-prerelease - Publishes pre-release connector builds (tagged as {version}-preview.{git-sha}) for all modified connectors in the PR.
    • /bump-progressive-rollout-version - Bumps connector version with an RC suffix (2.16.10-rc.1) for progressive rollouts (enableProgressiveRollout: true).
      • Example: /bump-progressive-rollout-version changelog="Add new feature for progressive rollout"
  • ☕️ JVM connectors:
    • /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
      Example: /update-connector-cdk-version connector=destination-bigquery
    • /bump-bulk-cdk-version bump=patch changelog='foo' - Bump the Bulk CDK's version. bump can be major/minor/patch.
  • 🐍 Python connectors:
    • /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
    • /poe source example lock - Alias for /poe connector source-example lock.
    • /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
    • /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.
  • ⚙️ Admin commands:
    • /force-merge reason="<REASON>" - Force merges the PR using admin privileges, bypassing CI checks. Requires a reason.
      Example: /force-merge reason="CI is flaky, tests pass locally"
📚 Show Repo Guidance

Helpful Resources

📝 Edit this welcome message.

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@github-actions
Copy link
Contributor

github-actions bot commented Jan 29, 2026

Deploy preview for airbyte-docs ready!

✅ Preview
https://airbyte-docs-3jc7kcwk3-airbyte-growth.vercel.app

Built with commit a22dfbd.
This pull request is being automatically deployed with vercel-action

</TabItem>
</Tabs>

## Complete example
Copy link
Contributor Author

@ian-at-airbyte ian-at-airbyte Jan 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have not tested this app yet. It's Devin's. Must test before merging.

3. **Handle callback**: After authorization, Airbyte redirects your user back to your app with a `secret_id`.
4. **Create connector**: You use that `secret_id` to create a connector without handling raw credentials.

```mermaid
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This diagram doesn't look right in light mode. It's fine in dark mode though. To be fixed.

@ian-at-airbyte ian-at-airbyte marked this pull request as ready for review January 30, 2026 01:19

4. **A redirect URL**: A URL in your app that receives the OAuth callback with the `secret_id`.

## Part 1: Configure OAuth overrides
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we make more clear this is optional?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants