auth_get_url
Generates an OAuth 2.0 authorization URL with a CSRF state token for the FreshBooks sign-in flow. Use it to connect an account or re-authenticate after a revoked or expired session.
Instructions
Generate an OAuth 2.0 authorization URL and a CSRF state token for the FreshBooks sign-in flow.
WHEN TO USE:
auth_status returns { connected: false }
User says "connect my FreshBooks account" or "sign in to FreshBooks"
Re-authenticating after a revoked or expired session
TAKES NO ARGUMENTS.
RETURNS: { url: "https://auth.freshbooks.com/oauth/authorize?...", state: "" }
WORKFLOW:
Call auth_get_url → share the url with the user
User visits the URL, authorizes, and is redirected — the redirect URL contains code and state query params
User pastes the code and state back → call auth_exchange_code with both values
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "auth_get_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||