0

Add Local Tax

by
Published Oct 17, 2025

Add Local Tax sends new local tax information directly to Paylocity Payroll/HR solution.

Script paylocity Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Paylocity = {
3
	clientId: string
4
	clientSecret: string
5
}
6
/**
7
 * Add Local Tax
8
 * Add Local Tax sends new local tax information directly to Paylocity Payroll/HR solution.
9
 */
10
export async function main(
11
	auth: Paylocity,
12
	companyId: string,
13
	employeeId: string,
14
	body: {
15
		exemptions?: number
16
		exemptions2?: number
17
		filingStatus?: string
18
		residentPSD?: string
19
		taxCode?: string
20
		workPSD?: string
21
	}
22
) {
23
	const url = new URL(
24
		`https://dc1prodgwext.paylocity.com/api/v1/companies/${companyId}/employees/${employeeId}/localTaxes`
25
	)
26

27
	const response = await fetch(url, {
28
		method: 'POST',
29
		headers: {
30
			'Content-Type': 'application/json',
31
			Authorization:
32
				'Bearer ' +
33
				(await getOAuthToken(auth, 'https://dc1prodgwext.paylocity.com/public/security/v1/token'))
34
		},
35
		body: JSON.stringify(body)
36
	})
37
	if (!response.ok) {
38
		const text = await response.text()
39
		throw new Error(`${response.status} ${text}`)
40
	}
41
	return await response.text()
42
}
43

44
async function getOAuthToken(auth: Paylocity, tokenUrl: string): Promise<string> {
45
	const params = new URLSearchParams({
46
		grant_type: 'client_credentials',
47
		client_id: auth.clientId,
48
		client_secret: auth.clientSecret
49
	})
50

51
	const response = await fetch(tokenUrl, {
52
		method: 'POST',
53
		headers: {
54
			Authorization: 'Basic ' + btoa(`${auth.clientId}:${auth.clientSecret}`),
55
			'Content-Type': 'application/x-www-form-urlencoded'
56
		},
57
		body: params.toString()
58
	})
59

60
	if (!response.ok) {
61
		const text = await response.text()
62
		throw new Error(`OAuth token request failed: ${response.status} ${text}`)
63
	}
64

65
	const data = await response.json()
66
	return data.access_token
67
}
68