← Back to Base

Documentation

How to connect and use Base integrations.

Getting started

Base is an AI-powered business platform that unifies your CRM, finance, contracts, email, and payments in one workspace. Connect your tools once and manage everything through the AI command bar.

HubSpot integration

  1. Sign in to Base at withbase.ai
  2. Navigate to the CRM module from the left sidebar
  3. Click Connect HubSpot and complete the OAuth flow
  4. All your contacts and deals will sync automatically

Two-way sync: Changes in Base appear in HubSpot instantly. Changes in HubSpot appear in Base via webhooks.

AI commands: Type "create contact John Smith john@acme.com" in the command bar and it syncs to HubSpot automatically.

Supported objects: Contacts, Deals, Notes, Calls.

Xero integration

  1. Navigate to the Finance module
  2. Click Connect Xero and authorize
  3. Your invoices, expenses, and cash balance will load automatically

Supported: Invoices, expenses, P&L reports, cash balance, aged receivables.

Stripe integration

  1. Navigate to the Payments module
  2. Click Connect Stripe and authorize
  3. Create invoices, track payments, and record payouts directly from Base

Gmail integration

  1. Navigate to the Email module
  2. Click Connect Gmail and authorize with your Google account
  3. Read, send, and draft emails directly from Base

BoldSign integration

  1. Navigate to the Contracts module
  2. Click Connect BoldSign
  3. Send, track, and void documents from Base

API & Zapier

Third-party apps (including Zapier) connect to Base via OAuth 2.0. All endpoints run on production URLs at withbase.ai.

OAuth 2.0 endpoints

Authorization URL
https://withbase.ai/oauth/authorize
Token URL
https://withbase.ai/oauth/token
Supported grant types
authorization_code, refresh_token
Scopes
profile

Authorization flow

  1. Redirect the user to the authorization URL with client_id, redirect_uri, response_type=code, and optional state and scope.
  2. The user signs in to Base (if needed) and approves access on the consent screen.
  3. Base redirects back to your redirect_uri with an authorization code.
  4. Exchange the code at the token URL using grant_type=authorization_code along with client_id, client_secret, and redirect_uri.

Token response

{
  "access_token": "…",
  "refresh_token": "…",
  "token_type": "Bearer",
  "expires_in": 3600
}

Get authenticated user

Use this endpoint to test a connection or fetch the signed-in user profile.

Method & URL
GET https://withbase.ai/api/me
Header
Authorization: Bearer {access_token}
{
  "id": "uuid",
  "email": "user@example.com",
  "name": "User Name",
  "organization_id": "uuid"
}

Connect via Zapier

  1. Create a Zap and search for Base.
  2. Click Connect a new account and sign in with your Base credentials.
  3. Approve access on the Base consent screen.
  4. Finish building your Zap using the available triggers and actions.

Support

Need help? Email us at support@withbase.ai