Créer un employé

POST

/api/payroll/employees

Crée un employé et sa première fonction en une seule opération ; numéro d'employé, NAS, nom, date de naissance, mode de paiement et bloc function sont requis (règles détaillées dans le corps de la requête). L'employé est actif si sa première fonction l'est ; les fonctions suivantes s'ajoutent via /by-id/{id}/functions. Le NAS, les numéros bancaires et le dossier fiscal ne sont jamais renvoyés ni journalisés en clair, et les pensions alimentaires se saisissent dans Acomba. La réponse (code 201) donne l'identifiant créé et les valeurs qu'Acomba n'a pas conservées.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Employé créé avec sa première fonction

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://relay.exostack.cloud//api/payroll/employees' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": {
        "city": "Laval",
        "country_code": "CA",
        "line1": "123, rue Principale",
        "postal_code": "H7N 1A1"
    },
    "arrival_date": "2026-10-13",
    "banking": {
        "account_number": "1234567",
        "branch_number": "30800",
        "institution_number": "815"
    },
    "birth_date": "1988-04-15",
    "code": "351",
    "emails": [
        {
            "address": "marie.tremblay@exemple.ca",
            "index": 1
        }
    ],
    "first_name": "Marie",
    "function": {
        "department_id": 1,
        "description": "Charpentier-menuisier",
        "is_active": true,
        "reference": 1
    },
    "gender": 2,
    "language": 12,
    "last_name": "Tremblay",
    "marital_status": 3,
    "payment_mode": 2,
    "phones": [
        {
            "description": "Cellulaire",
            "index": 1,
            "number": "450 555-0123"
        }
    ],
    "sin": "046 454 286",
    "tax": {
        "employment_insurance": {
            "account": 1
        },
        "federal": {
            "method": "salary",
            "use_table_exemption": true
        },
        "provincial": {
            "method": "salary",
            "use_table_exemption": true
        }
    }
}'

Response Example

{
    "action": "created",
    "code": "351",
    "fields_changed": [],
    "function": {
        "function_cp": 812,
        "index": 1,
        "unique": 1405
    },
    "id": 193,
    "warnings": []
}

Modified at 2026-10-09 19:59:12

Lister les employés

Rechercher des employés par nom de famille