Cocoon

Please ensure your census data, whether uploaded manually or through integration, includes only US-based employees, as we currently support only US employees.

Follow these instructions to set up an integration between TriNet HR Platform and Cocoon, which will allow Cocoon to automatically pull in relevant employee data into our platform.

Note: this integration does not enable Cocoon to push employee leave or pay data back to TriNet HR Platform.

In Cocoon Dashboard, navigate to “Settings” &gt; “HR &amp; Payroll”. Under “HR System”, you’ll see a “Set up integration” button. ​

Click the “Set up integration” button and you’ll be shown a modal that will ask you to read through and accept Cocoon’s Terms of Service.

Once you accept, you’ll be shown the Merge Link modal, which displays what, exactly, Cocoon will pull from TriNet HR Platform.

Once you click “Continue”, you’ll be taken to a screen in the modal where you’re shown how to retrieve the credential (API key) needed to create the “link” between Cocoon and TriNet HR Platform through Merge. This will also link to a<a href="https://help.merge.dev/en/articles/6974319-zenefits-api-key-authentication" rel="nofollow noopener noreferrer" target="_blank"> resource</a> Merge provides to show the exact steps you’d need to go through to retrieve the TriNet HR Platform API key. ​ ​

Optionally, you can follow along <a href="https://help.merge.dev/en/articles/6974319-trinet-hr-platform-how-do-i-link-with-my-api-key" rel="nofollow noopener noreferrer" target="_blank">here</a> for steps to retrieve the TriNet HR Platform API key needed. ​ ​

- Log into TriNet HR Platform, and navigate to “Company Profile”. ​ ​
 
 ​
- Navigate to the “Custom Integrations” tab. ​
 
 
- Under “REST API Access”, click “Add Token”. ​
 
 
- You’ll be asked to specify which permissions you wish to provision for this token. The default permissions already selected will be sufficient for Cocoon to produce census files based on the data pulled from TriNet HR Platform. For further clarification, the b fields should be selected:
 1. Under “Company Locations”:
 1. “Company’s Locations”
 2. Under “Company Departments”:
 1. “Company’s Departments”
 3. Under “Company”:
 1. “Companies”
 2. “EIN”
 3. “Legal name”
 4. “Legal address”
 4. Under “People”:
 1. “People”
 2. “Date of birth”
 3. “Person’s Department”
 4. “Home address”
 5. “Person’s Location”
 6. “Manager”
 7. “Personal email”
 8. “Personal phone”
 9. “Status”
 10. “Work email”
 11. “Work phone”
 5. Under “Employments”:
 1. “Employments”
 2. “Employment type”
 3. “Termination type”
 6. Under “Labor Groups”:
 1. “Labor group types”
 2. “Labor groups”
 7. Under “Time Durations”:
 1. “Time durations”

1. In Cocoon Dashboard, navigate to “Settings” &gt; “HR &amp; Payroll”. Under “HR System”, you’ll see a “Set up integration” button. ​
 
 
2. Click the “Set up integration” button and you’ll be shown a modal that will ask you to read through and accept Cocoon’s Terms of Service.
 
 
 
3. Once you accept, you’ll be shown the Merge Link modal, which displays what, exactly, Cocoon will pull from TriNet HR Platform.
 
4. Once you click “Continue”, you’ll be taken to a screen in the modal where you’re shown how to retrieve the credential (API key) needed to create the “link” between Cocoon and TriNet HR Platform through Merge. This will also link to a<a href="https://help.merge.dev/en/articles/6974319-zenefits-api-key-authentication" rel="nofollow noopener noreferrer" target="_blank"> resource</a> Merge provides to show the exact steps you’d need to go through to retrieve the TriNet HR Platform API key. ​ ​
 
 
5. Optionally, you can follow along <a href="https://help.merge.dev/en/articles/6974319-trinet-hr-platform-how-do-i-link-with-my-api-key" rel="nofollow noopener noreferrer" target="_blank">here</a> for steps to retrieve the TriNet HR Platform API key needed. ​ ​
 - Log into TriNet HR Platform, and navigate to “Company Profile”. ​ ​
 
 ​
 - Navigate to the “Custom Integrations” tab. ​
 
 
 - Under “REST API Access”, click “Add Token”. ​
 
 
 - You’ll be asked to specify which permissions you wish to provision for this token. The default permissions already selected will be sufficient for Cocoon to produce census files based on the data pulled from TriNet HR Platform. For further clarification, the b fields should be selected:
 1. Under “Company Locations”:
 1. “Company’s Locations”
 2. Under “Company Departments”:
 1. “Company’s Departments”
 3. Under “Company”:
 1. “Companies”
 2. “EIN”
 3. “Legal name”
 4. “Legal address”
 4. Under “People”:
 1. “People”
 2. “Date of birth”
 3. “Person’s Department”
 4. “Home address”
 5. “Person’s Location”
 6. “Manager”
 7. “Personal email”
 8. “Personal phone”
 9. “Status”
 10. “Work email”
 11. “Work phone”
 5. Under “Employments”:
 1. “Employments”
 2. “Employment type”
 3. “Termination type”
 6. Under “Labor Groups”:
 1. “Labor group types”
 2. “Labor groups”
 7. Under “Time Durations”:
 1. “Time durations”

e. Once you’ve submitted these selections for permissions, select the “eye” icon to reveal the API key, then copy and paste it into the “TriNet HR Platform API key” field in the Merge modal within the Cocoon dashboard. Then click “Submit”.

6. Once the API key is submitted, you’ll see a loading screen indicating that Merge is establishing the link between Cocoon and TriNet HR Platform, then a success screen once the link has been created.

Congratulations! You have now integrated your HRIS provider with Cocoon! No further action is needed on your end, Cocoon will now produce census files from the data pulled from your provider - an automatic sync will occur weekly to produce a new, accurate census file.

If you see an error, review the instructions to obtain the API key. If the issue persists, please contact Cocoon at <a href="mailto:support@cocoon.com" rel="nofollow noopener noreferrer" target="_blank">support@cocoon.com</a>.

Step-by-step instructions