- Recipes
- REST API to Personio employees
Connect REST API and Personio employees in our serverless environment
Use this template to Read a JSON array from one REST API using them to create employees using Personio API.
Share
Read a JSON array from one REST API
Used integrations:
- JavaScript
- Python
class HttpSourceRestJsonGet {
async init() {
// TODO: Create your http credential with endpoint information:
// More info at https://yepcode.io/docs/integrations/http/#credential-configuration
// It may manage headers or authentication
this.httpClient = yepcode.integration.http("your-http-credential-name");
}
async fetch(publish, done) {
// TODO: Customize the path to the API call
await this.httpClient
.get("/the-get-rest-api-path", {
params: {
// TODO: Provide optional HTTP parameters
},
})
.then(async ({
data
}) => {
// Publish each JSON object in array
for (const item of data) {
await publish(item);
}
});
done();
}
async close() {}
}
class HttpSourceRestJsonGet:
def setup(self):
# TODO: Create your http credential with endpoint information:
# More info at https://yepcode.io/docs/integrations/http/#credential-configuration
# It may manage headers or authentication
self.session = yepcode.integration.http("your-http-get-credential-name")
def generator(self):
# TODO: Customize the path to the API call as well as http parameters
response = self.session.get("/the-get-rest-api-path", params={})
response.raise_for_status()
# Publish each JSON object in array
for item in response.json():
yield item
def close(self):
pass
Do you need help solving this integration with YepCode?
Let's talkCreate employees using Personio API
Used integrations:
- JavaScript
- Python
class HttpTargetPersonioCreateEmployee {
async init() {
// TODO: Create your http credential with personio information:
// More info at https://yepcode.io/docs/integrations/http/#credential-configuration
// baseUrl: https://api.personio.de/v1
this.httpClient = yepcode.integration.http(
"your-http-personio-credential-name"
);
// TODO: You need to define two env vars (https://yepcode.io/docs/processes/team-variables)
const {
data: {
bearerToken
},
} = await this.httpClient.post("/auth", {
client_id: yepcode.env.PERSONIO_CLIENT_ID,
client_secret: yepcode.env.PERSONIO_CLIENT_SECRET,
});
this.bearerToken = bearerToken;
}
async consume(item) {
// TODO: Customize your request checking the API documentation:
// https://developer.personio.de/reference/post_company-employees
const response = await this.httpClient.post(
"/company/employees", {
// TODO: map your fields from item
employee: {
email: item.email,
first_name: item.first_name,
last_name: item.last_name,
gender: "male",
position: "developer",
subcompany: "ACME",
department: "IT",
office: "Madrid",
hire_date: "2020-01-31",
weekly_working_hours: 40,
custom_attributes: {
"dynamic_ {{ field uid }} ": "German",
},
},
}, {
headers: {
Authorization: `Bearer ${this.bearerToken}`,
},
}
);
// A new token is recieved in each request (https://developer.personio.de/reference/auth-1)
this.bearerToken = response.headers.authorization;
}
async close() {}
}
class HttpTargetPersonioCreateEmployee:
def setup(self):
# TODO: Create your http credential with personio information:
# More info at https://yepcode.io/docs/integrations/http/#credential-configuration
# baseUrl: https://api.personio.de/v1
self.session = yepcode.integration.http("your-http-personio-credential-name")
# TODO: You need to define two env vars (https://yepcode.io/docs/processes/team-variables)
response = self.session.post(
"/auth",
json={
"client_id": yepcode.env.PERSONIO_CLIENT_ID,
"client_secret": yepcode.env.PERSONIO_CLIENT_SECRET,
},
)
response.raise_for_status()
self.token = response.json()["bearerToken"]
def consume(self, generator, done):
for item in generator:
self.process(item)
done()
def process(self, item):
# TODO: map your fields from item
employee = {
"email": item["email"],
"first_name": item["first_name"],
"last_name": item["last_name"],
"gender": "female",
"position": "developer",
"subcompany": "yepcode",
"department": "IT",
"office": "Berlin",
"hire_date": "2021-01-01",
"weekly_working_hours": 40,
"custom_attributes": {
"custom": "value",
},
}
# TODO: Customize your request checking the API documentation:
# https://developer.personio.de/reference/post_company-employees
response = self.session.post(
"/company/employees",
json=employee,
headers={"Authorization": f"Bearer {self.token}"},
)
response.raise_for_status()
# A new token is recieved in each request (https://developer.personio.de/reference/auth-1)
self.token = response.headers["authorization"]
def close(self):
pass
FAQs
YepCode is a SaaS platform that enables the creation, execution and monitoring of integrations and automations using source code in a serverless environment.
We like to call it the Zapier for developers, since we bring all the agility and benefits of NoCode tools (avoid server provisioning, environment configuration, deployments,...), but with all the power of being able to use a programming language like JavaScript or Python.
These recipes are an excellent starting point for creating your own YepCode processes and solving complex integration and automation problems.
You only have to complete the sign up form and your account will be created with our FREE plan (no credit card required).
YepCode has been created with a clear enterprise focus, offering a multi-tenant environment, team management capabilities, high security and auditing standards, Identity Provider (IdP) integrations, and on-premise options. It serves as the Swiss army knife for engineering teams, especially those requiring the extraction or transmission of information to external systems. It excels in scenarios demanding flexibility and adaptability to change within the process.
Sure! You only need to configure YepCode servers to establish a connection with that service. Check our docs page to get more information.