Calimatic Connect|Documentation
PricingSign In
FreshBooks

FreshBooks

Manage invoices and expenses with FreshBooks.

Accountingoauthproxy

Connect FreshBooks

FreshBooks uses OAuth for authentication. Redirect your user to the login URL to start the authorization flow. After the user authorizes access, the callback is handled automatically.

# Redirect user to start OAuth flow
GET /auth/freshbooks/login?account_id=YOUR_ACCOUNT_ID&redirect_uri=https://your-app.com/callback
# Callback handled automatically at
GET /auth/freshbooks/callback

Make API Calls via Proxy

Use the proxy endpoint to make authenticated API calls to FreshBooks without managing tokens yourself. Calimatic Connect handles credential injection and token refresh automatically.

POST /connect/v1/proxy/freshbooks
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"method": "GET",
"path": "/me"
}

Check Status

Verify whether your FreshBooks connection is active and credentials are valid:

GET /connect/v1/providers/freshbooks/status
# Headers
Authorization: YOUR_JWT_TOKEN

Disconnect

Remove the FreshBooks connection and revoke stored credentials:

DELETE /connect/v1/providers/freshbooks/disconnect
# Headers
Authorization: YOUR_JWT_TOKEN