Alegra – Connection Guide
Cloud-based invoicing, accounting and POS software popular across Latin America (Mexico, Colombia, Peru, Spain, Dominican Republic, Argentina, Chile and others) for SMBs and entrepreneurs.
How to connect your Alegra account
Alegra is a cloud-based invoicing, accounting and POS platform widely used by SMBs and entrepreneurs across Latin America (Mexico, Colombia, Peru, Spain, Dominican Republic, Argentina, Chile and others). It exposes a REST API that lets external applications synchronise contacts, invoices, bills, items, taxes and chart-of-accounts data.
To connect your Alegra account to Vault you need the email you use to sign in to Alegra and an API token issued from your Alegra dashboard. Both pieces are listed under the manual-integration screen described below.
1. Open the manual integration screen
- Sign in to your Alegra account at app.alegra.com (or your country-specific subdomain, e.g.
app.alegra.com/mx,app.alegra.com/co). - Click your profile menu in the top right corner.
- Choose Configuración → Integraciones (or Settings → Integrations).
- Select the Integración Manual (API) tab.
2. Copy your credentials
On the Datos de usuario card you will see two fields:
| Field | What to copy |
|---|---|
| Usuario | The email address associated with your Alegra account (e.g. you@acme.com) |
| Token | The API token Alegra has issued for you (16+ character alphanumeric string) |
If you have never used the API before, Alegra will display a token automatically. If the token has been compromised or you simply want a fresh one, click Renovar token — the previous token is invalidated immediately.
Treat the token like a password. Anyone with the Usuario + Token pair can read and write data in your Alegra account.
3. Paste them into Vault
In Vault, when you enable the Alegra connection, you will be prompted for two values:
- Email → paste the Usuario value from Alegra.
- API Token → paste the Token value from Alegra.
Save the connection. Vault verifies the credentials by calling GET /company on Alegra; if both fields are correct the connection status switches to Connected within a few seconds.
Troubleshooting
- "Invalid credentials" or 401: confirm there are no leading/trailing spaces, that the email matches the one in Alegra exactly, and that you have not rotated the token in another session.
- 403 on certain resources (journal entries, fixed assets, attachments, payment methods, banks): these endpoints require a higher-tier Alegra plan than the manual API integration allows by default. Upgrade your Alegra subscription or contact Alegra support.
- Multi-country accounts: the API base URL (
https://api.alegra.com/api/v1) is the same regardless of your tenant's country — the token already scopes you to the right tenant.