No articles found for “”.
Connecting SpireSlip to TaxSpire
The TaxSpire integration lets your PAYE and pension data flow automatically from SpireSlip to TaxSpire after each approved payroll run. There is no manual export, no CSV juggling, and no risk of forgetting a month. TaxSpire pulls the schedules directly from SpireSlip on a fixed cadence using a scoped API key that you generate once.
Step 1: Generate an API key in SpireSlip
- Go to Entities, open your entity, and choose the Integrations tab.
- Under Generate new key, type a Key name, for example TaxSpire.
- Under Permissions, keep only PAYE data (
paye:read) and Pension data (pension:read) ticked; these are the only ones TaxSpire needs. - Click Generate API key, then copy the key straight away. It is shown once only and cannot be retrieved later.
- Make a note of the Entity ID shown above the key form. TaxSpire needs it together with the API key.
Step 2: Add the key to TaxSpire
- In TaxSpire, open Settings and choose Connected accounts, then SpireSlip.
- Paste the API key and your SpireSlip Entity ID into the form.
- Click Save.
Step 3: That is it
TaxSpire automatically pulls your PAYE and pension schedules after each approved payroll run. No manual export is needed. You can still download the same data from Reports at any time if you need a copy.
What data TaxSpire can access
- The PAYE schedule for each approved run, or for a whole month when you pay on more than one date in that month (
paye:readscope). - The pension schedule for each approved run or month (
pension:readscope). - The list of months that have approved runs, so TaxSpire files each month once. Test runs and drafts are never shared.
Bank account numbers and NIN are never included in any API response. Employee TINs and pension details (PFA name and code, and the RSA PIN) are included in the PAYE and pension schedules because filing needs them, and only for the entity the API key was created for.
Troubleshooting
- entity_mismatch error. Check that the Entity ID you entered in TaxSpire matches the one shown in SpireSlip under Entities → your entity → Integrations. The two must be the same exact number.
- plan_not_eligible error. API access requires a Complete, Enterprise, or Accountant plan. Upgrade from Billing and try again.
- Key not working. The key may have been revoked. Generate a new key in SpireSlip and update the value in TaxSpire.