Overview
PaySpace (acquired by Deel) is a South African + African payroll + HR platform – payroll runs, employees, leave, attendance. The Automize PaySpace connector covers employees, companies, payslips, departments, and leave types.
- Regions: Headquartered in SA, payroll engines for many African countries (SA, KE, NG, BW, NA, MZ, AO, MU, GH, UG, TZ, ZW, etc.).
- Plans: Standard, Premium, Enterprise – API on Premium+.
Setting up the connection
Auth type: OAuth 2.0 (Client Credentials).
- Contact your PaySpace account manager to enable API access.
- PaySpace provides Client ID + Client Secret for OAuth Client Credentials.
- In Automize, open Settings → Connectors → PaySpace → Add connection. Paste credentials + environment (production / staging).
Find your credentials at https://www.payspace.com/.
Rate limits
Per-tenant limits. Connector retries 429 with backoff.
Data model
Payroll primitives:
Company (legal entity) ─┬─ Departments
├─ Employees ─── Payslips (per period)
└─ Leave TypesAvailable operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create employee | General | Create a new employee record in PaySpace. |
| Get employee | General | Get employee details by ID from PaySpace. |
| Get payslip | General | Get payslip data for an employee and period from PaySpace. |
| List companies | General | List accessible companies in PaySpace. |
| List departments | General | List departments in PaySpace. |
| List employees | General | List employees in a company via PaySpace. |
| List leave types | General | List leave type definitions in PaySpace. |
| Update employee | General | Update employee details in PaySpace. |
Operations
Create employee
Create a new employee record in PaySpace.
| Parameter | Required | Type | Description |
|---|---|---|---|
Employee data (JSON) fields | Yes | textarea |
Tips
- fields: structured object with personal + employment + tax + banking info.
- PaySpace requires SA-specific fields (ID number, tax reference) for SA employees.
Get employee
Get employee details by ID from PaySpace.
| Parameter | Required | Type | Description |
|---|---|---|---|
Employee ID employee_id | Yes | text |
Tips
- employee_id. Returns full profile + payroll info + tax details.
Get payslip
Get payslip data for an employee and period from PaySpace.
| Parameter | Required | Type | Description |
|---|---|---|---|
Employee ID employee_id | Yes | text | |
Pay period period | No | text |
Tips
- employee_id + period (YYYY-MM). Returns gross/net/deductions breakdown.
List companies
List accessible companies in PaySpace.
No input parameters.
Tips
- Returns companies you have access to. One PaySpace tenant may have multiple companies (separate legal entities).
List departments
List departments in PaySpace.
No input parameters.
Tips
- Departments per company. Used for cost-center reporting.
List employees
List employees in a company via PaySpace.
No input parameters.
Tips
- Filter by company_id. Filter by status (active, terminated).
List leave types
List leave type definitions in PaySpace.
No input parameters.
Tips
- Leave categories (annual, sick, family, etc.). Each has an annual entitlement.
Update employee
Update employee details in PaySpace.
| Parameter | Required | Type | Description |
|---|---|---|---|
Employee ID employee_id | Yes | text | |
Fields (JSON) fields | Yes | textarea |
Tips
- PATCH-style on fields. Termination dates flow through payroll automatically.
FAQ
- PaySpace + Deel – same?
- Deel acquired PaySpace. Currently still separate products + APIs. Migration to a unified API may happen – track Deel's announcements.
- SA-specific compliance?
- PaySpace handles UIF, PAYE, SDL, Workmen's Compensation, EMP201/501 filings. Required fields like SA ID number + tax reference enforced on Create Employee.
- Sandbox?
- Yes – staging environment available. Set environment=staging on the connection.