0

Passing applications to Personio

by
Published Oct 17, 2025

DEPRECATED: This method of passing application to Personio is deprecated and will only receive bugfixes.

Script personio Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Personio = {
3
	clientId: string
4
	clientSecret: string
5
}
6
type Base64 = string
7
/**
8
 * Passing applications to Personio
9
 *  DEPRECATED: This method of passing application to Personio is deprecated and will only receive bugfixes.
10
 */
11
export async function main(
12
	auth: Personio,
13
	X_Company_ID: string,
14
	body: {
15
		company_id: number
16
		access_token: string
17
		job_position_id: number
18
		first_name: string
19
		last_name: string
20
		email: string
21
		gender?: 'undefined' | 'male' | 'female' | 'diverse'
22
		recruiting_channel_id?: number
23
		external_posting_id?: string
24
		phone?: string
25
		location?: string
26
		salary_expectations?: string
27
		available_from?: string
28
		'categorised_documents[n][file]'?: {
29
			base64: Base64
30
			type:
31
				| 'image/png'
32
				| 'image/jpeg'
33
				| 'image/gif'
34
				| 'application/pdf'
35
				| 'appication/json'
36
				| 'text/csv'
37
				| 'text/plain'
38
				| 'audio/mpeg'
39
				| 'audio/wav'
40
				| 'video/mp4'
41
			name: string
42
		}
43
		'categorised_documents[n][category]'?: string
44
		'documents[n]'?: {
45
			base64: Base64
46
			type:
47
				| 'image/png'
48
				| 'image/jpeg'
49
				| 'image/gif'
50
				| 'application/pdf'
51
				| 'appication/json'
52
				| 'text/csv'
53
				| 'text/plain'
54
				| 'audio/mpeg'
55
				| 'audio/wav'
56
				| 'video/mp4'
57
			name: string
58
		}
59
		'document{n}'?: { file?: string }
60
		message?: string
61
		tags?: {}
62
		birthday?: string
63
		'custom_attribute_{id}'?: number
64
	},
65
	X_Personio_Partner_ID?: string,
66
	X_Personio_App_ID?: string
67
) {
68
	const url = new URL(`https://api.personio.de/recruiting/applicant`)
69

70
	const formData = new FormData()
71
	for (const [k, v] of Object.entries(body)) {
72
		if (v !== undefined && v !== '') {
73
			if (['categorised_documents[n][file]', 'documents[n]'].includes(k)) {
74
				const { base64, type, name } = v as {
75
					base64: Base64
76
					type: string
77
					name: string
78
				}
79
				formData.append(
80
					k,
81
					new Blob([Uint8Array.from(atob(base64), (m) => m.codePointAt(0)!)], {
82
						type
83
					}),
84
					name
85
				)
86
			} else {
87
				formData.append(k, String(v))
88
			}
89
		}
90
	}
91
	const response = await fetch(url, {
92
		method: 'POST',
93
		headers: {
94
			...(X_Personio_Partner_ID ? { 'X-Personio-Partner-ID': X_Personio_Partner_ID } : {}),
95
			...(X_Personio_App_ID ? { 'X-Personio-App-ID': X_Personio_App_ID } : {}),
96
			'X-Company-ID': X_Company_ID,
97
			Authorization: 'Bearer ' + (await getOAuthToken(auth, 'https://api.personio.de/oauth2/token'))
98
		},
99
		body: formData
100
	})
101
	if (!response.ok) {
102
		const text = await response.text()
103
		throw new Error(`${response.status} ${text}`)
104
	}
105
	return await response.json()
106
}
107

108
async function getOAuthToken(auth: Personio, tokenUrl: string): Promise<string> {
109
	const params = new URLSearchParams({
110
		grant_type: 'client_credentials',
111
		client_id: auth.clientId,
112
		client_secret: auth.clientSecret
113
	})
114

115
	const response = await fetch(tokenUrl, {
116
		method: 'POST',
117
		headers: {
118
			Authorization: 'Basic ' + btoa(`${auth.clientId}:${auth.clientSecret}`),
119
			'Content-Type': 'application/x-www-form-urlencoded'
120
		},
121
		body: params.toString()
122
	})
123

124
	if (!response.ok) {
125
		const text = await response.text()
126
		throw new Error(`OAuth token request failed: ${response.status} ${text}`)
127
	}
128

129
	const data = await response.json()
130
	return data.access_token
131
}
132