xero_connection_management

Handles secure X.509 certificate-based authentication for REST API access.

6|1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/CleanExpo/ATO --skill xero-connection-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xero_connection_management
Source: https://github.com/CleanExpo/ATO/tree/main/.agent/skills/xero_connection_management
Command: npx skills add https://github.com/CleanExpo/ATO --skill xero-connection-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the end-to-end setup and ongoing maintenance of a Xero OAuth 2.0 connection for the Australian Tax Optimizer application, ensuring secure credentials, reliable authentication flows, and synchronized environments.

Core Features & Use Cases

  • Configure and validate Xero app registration in the Developer Portal, including redirect URIs and required scopes.
  • Synchronize environment variables across local and production deployments (XERO_CLIENT_ID, XERO_CLIENT_SECRET, NEXT_PUBLIC_BASE_URL).
  • Manage token lifecycles, verify scopes, and diagnose common connection issues during onboarding and maintenance.
  • Use Case: When onboarding a new environment or rotating credentials, run this skill to establish a working Xero connection and seed the xero_connections table.

Quick Start

Configure the Xero app in the Developer Portal with the required redirect URIs and scopes. Update local and production environment variables to include XERO_CLIENT_ID, XERO_CLIENT_SECRET, and NEXT_PUBLIC_BASE_URL. From the dashboard, initiate the Xero connection to seed the xero_connections table and verify the OAuth flow.

Frequently Asked Questions about xero_connection_management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Xero OAuth 2.0 authentication for my application?

To set up Xero OAuth 2.0 authentication, you need to configure your app in the Xero Developer Portal with the correct redirect URIs and scopes, then synchronize your environment variables like XERO_CLIENT_ID and XERO_CLIENT_SECRET across local and production deployments.

What environment variables are required for Xero OAuth integration?

Xero OAuth integration requires three specific environment variables: XERO_CLIENT_ID, XERO_CLIENT_SECRET, and NEXT_PUBLIC_BASE_URL. These credentials must be synchronized across your local and production deployments to ensure reliable authentication flows.

Why does my Xero OAuth connection fail during token validation?

Xero OAuth connection failures during token validation often stem from misconfigured redirect URIs, incorrect scopes in the Developer Portal, or missing environment variables. This skill diagnoses these common connection issues and manages the token lifecycle to maintain secure access.

Can I use Node.js tooling to manage Xero API token lifecycles?

Yes, you can use basic Node.js tooling to manage Xero API token lifecycles. This skill automates token management, verifies scopes, and handles authentication flow troubleshooting, requiring access to your Xero app credentials and environment variables to operate effectively.

What's the best way to synchronize Xero credentials across local and production environments?

The best way to synchronize Xero credentials is to automate the configuration of your XERO_CLIENT_ID, XERO_CLIENT_SECRET, and NEXT_PUBLIC_BASE_URL variables across environments. This ensures secure credentials and reliable authentication flows during onboarding and credential rotation.

Do I need to seed a database table when configuring Xero OAuth?

Yes, configuring Xero OAuth requires seeding the xero_connections table. After updating your environment variables and configuring the Xero app in the Developer Portal, you initiate the Xero connection from your dashboard to populate this table and verify the OAuth flow.