Tātou integration overview

note

Each job may have only one active Tātou integration. Disabled integrations do not count as active. If you need help setting up integrations, see Setting up integrations.

Uniqueness detection

PICMI only checks for duplicates based on email, not Staff ID. This means that if an employee’s email is different, PICMI will assume they are a new hire, even if they are actually the same person in Tātou.

Tātou: Integration configuration

Configuration	Description	Values
Security token	Integrations available in the system	Text (required)
Default contract type	Contract type to apply to all applications	Casual
Default earning rule	Contract type to apply to all applications (introduced Sept 2026)	Tatou earning rules
Default role	Tatou earning rules available on this organisation	Tatou roles
Default employee status on creation	Tatou employee status set on employee creation	Tatou employee statuses

PICMI-Tātou integration fields

Field Name	Description	Validation/Constraint/Default Value	Source
ID	Unique identifier		Integration Configuration
First names	Given name(s) of the individual.		Personal Information
Surname	Family name of the individual.		Personal Information
Email	Email address of the individual.		Personal Information
Birthdate	Date of birth of the individual.		Personal Information
Nationality	Nationality of the individual.		Personal Information
Next hourly rate	The remuneration rate for the individual.		Job
Effective from	Start date for the next hourly rate to take effect.	Plus one day	Job
Job title	Title of the individual’s position.		Job
Start date	Start date of employment or contract.		Job
Recruitment type	Type of recruitment for the individual.	Default (NZ Employee)	Integration Configuration
Contract type	Type of contract under which the individual is employed.		Integration Configuration
Primary role	Primary role of the individual in the organisation.		Integration Configuration
Status	Employment status of the individual (e.g., active, inactive).	Inactive	Integration Configuration

FAQ

How can I view the staff ID?

+

Duplicate Tātou integration error

+

General troubleshooting

• General integration troubleshooting
• Integration FAQs