Skip to content

Commit cd5d02a

Browse files
Update Playroll.md
1 parent 3fe6479 commit cd5d02a

1 file changed

Lines changed: 51 additions & 61 deletions

File tree

Lines changed: 51 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,99 +1,89 @@
11
---
2-
title: Playroll Integration
2+
title: Playroll
33
description: Learn how to connect Expensify with Playroll to automatically sync approved expenses for HR and EOR processing.
44
keywords: [Expensify Classic, Playroll, HR, EOR, expense sync, integration, payroll]
5-
internalScope: Audience is Workspace Admins and Workspace Owners. Covers connecting Expensify Classic to Playroll for one-way expense syncing. Does not cover Playroll configuration beyond the Expensify integration.
5+
internalScope: Audience is Workspace Admins and Workspace Owners. Covers connecting to Playroll for one-way expense syncing. Does not cover Playroll configuration beyond the Expensify integration.
66
---
77

8+
# Playroll
89

910
The Expensify-Playroll integration allows approved expenses in Expensify to automatically sync into Playroll for processing. This is a one-way integration (Expensify to Playroll only) — changes made after syncing will not sync back.
1011

1112
**Important:** Only approved expenses will sync, and expenses without receipts will not sync to Playroll.
1213

1314
---
15+
1416
## Who can connect Expensify to Playroll
15-
# Prerequisites
1617

17-
Before setting up the integration, ensure the following:
18+
You can connect Expensify to Playroll if:
19+
20+
- You are a Workspace Admin or Workspace Owner
21+
- You have permission to configure integrations in Playroll
22+
- You are signed into the Expensify account that owns or administers the workspace
1823

19-
- You are a **Workspace Admin** or **Workspace Owner** in Expensify
20-
- You have Playroll integration permissions
21-
- You are logged into the same Expensify account that owns or administers the workspace
22-
- You can access Expensify Classic
24+
This feature is not available on mobile.
2325

2426
---
2527

2628
## How to connect Expensify to Playroll
2729

28-
## Step 1: Switch to Expensify Classic
29-
30-
1. Log into Expensify.
31-
2. Click your account logo.
32-
3. Select **Troubleshoot**.
33-
4. Click **Switch to Expensify Classic**.
30+
Before connecting Playroll, configure the required workspace settings in Expensify.
3431

35-
## Step 2: Enable Public Receipt Visibility
36-
37-
1. Go to **Settings > Workspaces**.
38-
2. Select the workspace you want to connect.
32+
1. In the navigation tabs on the left, go to **Settings > Workspaces**.
33+
2. Select your workspace.
3934
3. Go to **Rules**.
4035
4. Enable **Public Receipt Visibility**.
36+
5. Set **Receipt Required Amount** to **$0**.
37+
6. Save your changes.
38+
39+
Then connect the integration in Playroll.
4140

42-
{% include info.html %}
43-
If Public Receipt Visibility is not enabled, expenses will not sync to Playroll.
44-
{% include end-info.html %}
41+
1. In Playroll, go to **Dashboard > Tools > Integrations**.
42+
2. Select **Expensify**.
43+
3. Open the **Configuration** tab.
44+
4. Click **Connect**.
45+
5. In Expensify, click **Find our Partner ID**.
46+
6. Copy the **Partner User ID** and **Partner User Secret**.
47+
7. Paste the credentials into Playroll.
48+
8. Click **Submit**.
4549

46-
## Step 3: Set Receipt Required Amount to $0
50+
After the integration connects successfully, Playroll displays the status as **Active / Connected**.
4751

48-
1. In the **Rules** section, locate **Receipt Required Amount**.
49-
2. Set the value to **$0**.
50-
3. Save your changes.
52+
Employee email addresses in Expensify must match the Personal Email addresses in Playroll.
5153

52-
{% include info.html %}
53-
Expenses without receipts do not sync to Playroll. Setting this to $0 ensures all expenses have receipts attached.
54-
{% include end-info.html %}
54+
---
5555

56-
## Step 4: Confirm Workspace Permissions
56+
## What happens after you connect Expensify to Playroll
5757

58-
Verify that the user configuring the integration is a **Workspace Admin** or **Workspace Owner**.
58+
After the integration is connected:
5959

60-
## Step 5: Connect Expensify to Playroll
60+
- Approved expenses automatically sync from Expensify to Playroll
61+
- Expenses without attached receipts do not sync
62+
- Changes made after syncing do not sync back into Expensify
63+
- Expense category mappings in Playroll determine how synced expenses appear in Playroll
6164

62-
1. In Playroll, go to **Dashboard**.
63-
2. Click **Tools > Integrations**.
64-
3. Select **Expensify**.
65-
4. Open the **Configuration** tab.
66-
5. Click **Connect**.
67-
6. You will need your **Partner User ID** and **Partner User Secret**. To get these credentials:
68-
- While logged into Expensify, click **Find our Partner ID**.
69-
- Copy your **Partner User ID** and **Partner User Secret**.
70-
- Paste them into Playroll.
71-
- Click **Submit**.
65+
---
7266

73-
A successful setup will display **Active / Connected**.
67+
# FAQ
7468

75-
## Step 6: Map Expense Categories
69+
## Why are expenses not syncing to Playroll?
7670

77-
1. Open the Expensify integration page in Playroll.
78-
2. Go to **Expense Categories**.
79-
3. Click **Map Categories**.
80-
4. Match your Expensify categories to the corresponding Playroll categories.
81-
5. Save your mappings.
71+
Expenses may not sync if:
8272

83-
For example:
84-
- Expensify "Car" → Playroll "Car Rental"
85-
- Expensify "Equipment" → Playroll "Equipment"
73+
- The expense is not approved
74+
- The expense does not include a receipt
75+
- **Public Receipt Visibility** is disabled
76+
- Employee email addresses do not match between Expensify and Playroll
77+
- Expense categories are not mapped in Playroll
8678

87-
{% include info.html %}
88-
Employee email addresses in Expensify must match Personal Emails in Playroll for expenses to sync correctly.
89-
## How to verify the Playroll integration is set up correctly
79+
## Can members connect Expensify to Playroll?
9080

91-
---
81+
No. Only Workspace Admins and Workspace Owners can configure the integration.
82+
83+
## Does the Playroll integration sync changes back into Expensify?
84+
85+
No. The integration only syncs expenses from Expensify to Playroll.
9286

93-
# Completion Checklist
87+
## Can I connect Expensify to Playroll on mobile?
9488

95-
- [ ] Public Receipt Visibility enabled
96-
- [ ] Receipt Required Amount set to $0
97-
- [ ] Correct workspace permissions confirmed
98-
- [ ] Expensify connected to Playroll (showing "Active / Connected")
99-
- [ ] Expense categories mapped and saved
89+
No. This feature is not available on mobile.

0 commit comments

Comments
 (0)