# Sage setup for PopMCP If PopMCP shows Sign in with Sage with no fields, click it and sign in with your Sage Accounting login. If it asks for a Client ID and Client Secret, create a free app in Sage's developer portal with PopMCP's callback URL, enter its details, then sign in the same way. This is Sage Accounting only: Sage 50, Sage 200 and Sage Intacct are separate products and are not covered. - Auth: OAuth authorization - Setup time: 5 min - API base URL: https://api.accounting.sage.com/v3.1 - Credentials screen: https://developerselfservice.sageone.com - Provider docs: https://developer.sage.com/accounting/docs/v1.0.0/guides/learning/getting-started/client_app_registration ## Before you begin - A Sage Accounting login with an active trial or subscription on the business you want to connect. Sage's documents list its API mainly for the UK, Ireland and Canada. - To use your own app: a free Sage developer account at developerselfservice.sageone.com, and PopMCP's callback URL from the connect form: https://app.popmcp.com/api/providers/sage/callback - Your developer login and your Sage Accounting login are separate. The developer login makes the app. The Sage Accounting login approves access, and it is the one that can open a business. ## Get your credentials ### 1. Check whether you need an app at all Open Sage in PopMCP. If you see Sign in with Sage and no fields, click it, skip to the last two steps, and sign in with your Sage Accounting login. If the form asks for a Client ID and Client Secret, carry on. ### 2. Sign in to Sage's developer portal Go to developerselfservice.sageone.com and sign in, or sign up with GitHub or an email address. It is free. If you use an email address, Sage sends a link to confirm it. Screen: https://developerselfservice.sageone.com ### 3. Create an app with PopMCP's callback URL Click Create App. Enter a name such as `PopMCP` under App Name and your address under Email Address. Under Callback URLs paste `https://app.popmcp.com/api/providers/sage/callback` exactly: Sage treats capital letters as different. Homepage URL is optional. Click Save. Screen: https://developerselfservice.sageone.com ### 4. Copy the Client ID and Client Secret Click the app's name to open it. Click Show next to Client ID and Client Secret, and copy both. Screen: https://developerselfservice.sageone.com ### 5. Sign in with your Sage Accounting login Enter the Client ID and Client Secret in PopMCP and click Sign in with Sage. On Sage's page choose your business's country, sign in with the login you use for Sage Accounting, not your developer login, and allow access. ### 6. Choose your businesses PopMCP lists every business that login can open. Tick the ones to connect and choose a workspace for each. Each becomes its own connection, so you can have an AI client work in one business without touching the others. ## Fields PopMCP asks for - Client ID (clientId) [required]: Only needed to use your own app. Sign in at developerselfservice.sageone.com, click Create App, give it a name and your email, paste the Callback URL shown here, and click Save. Then open the app and click Show next to Client ID and Client Secret. - Client Secret (clientSecret) [required]: On the same page as the Client ID. Stored encrypted and used only on our server. ## Callback URL to register https://app.popmcp.com/api/providers/sage/callback ## Scopes requested - full_access ## Verify PopMCP shows Sage as Connected under your business's name, and sage_business_overview returns the business with its ledger accounts, tax rates and bank accounts. ## Troubleshooting ### Sage shows an error page instead of asking for access Cause: PopMCP's callback URL is not on your app, or differs by a character. Sage treats capital letters as different. Fix: On your app's page set **Callback URLs** to include `https://app.popmcp.com/api/providers/sage/callback` and connect again. ### "This Sage sign-in has no Sage Accounting business", or an error saying the email is already in use Cause: You signed in with your Sage developer login, which is not linked to a business, or chose a country that does not match your business. Fix: Connect again with the login you use for Sage Accounting. If Sage does not offer the country page, visit `https://www.sageone.com/?clear` to clear Sage's country choice, then try again. ### "Sage did not accept the app's Client ID and Client Secret" Cause: A value was mistyped or copied partly. Fix: Click **Show** on your app's page, copy both values again, and connect again. ### "Sage's sign-in code expired or was already used" Cause: Sage's code lasts 60 seconds and works once. Fix: Connect again from the start. ### "This business has no active Sage subscription" Cause: The business's trial ended or its subscription was cancelled. Fix: Reactivate it in Sage Accounting, or choose another business, then connect again. ### "Sage no longer accepts this sign-in" Cause: Sage ends a sign-in after 31 days without use, or when access is removed in Sage. A new sign-in to the same app by the same user can also replace the old one. Fix: Connect Sage again. Your connections from one sign-in renew together. ### A tool answers that the Sage user does not have the role Cause: Calls run as the Sage user who connected, with that user's roles. A restricted user cannot delete, and a read-only user cannot write. Fix: A business owner can change the role in Sage under Settings, Manage Users. Or connect as a user who has it. ### A tool answers that Sage does not offer it on your plan Cause: Some of Sage's API is not on every plan. Creating purchase invoices, products, services and quotes is not on Sage Accounting Start, and stock needs Plus. Fix: Do it another way, or move to a plan that includes it. sage_describe_tool lists the plans for each tool. ### My Sage 50, Sage 200 or Sage Intacct data does not appear Cause: Those are separate products with their own APIs. This connector is for Sage Accounting. Fix: Use this connector with a Sage Accounting business only. --- Source: https://www.docs.popmcp.com/docs/integrations/sage/