Import user locations - Lucca API

Documentation

Files

Organization Structure API

Core HR API

Recruitment API

Expenses API

Invoices API

Absences API

Office API

Project API

Schedule API

Timesheet API

Mealvouchers API

Compensation API

Training API

Import user locations

curl --request POST \
  --url https://{host}/work-locations/public/api/imports/user-locations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data'

import requests

url = "https://{host}/work-locations/public/api/imports/user-locations"

payload = "-----011000010111000001101001\r\n-----011000010111000001101001--"
headers = {
    "Content-Type": "multipart/form-data",
    "Authorization": "<authorization>"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();

const options = {method: 'POST', headers: {Authorization: '<authorization>'}};

options.body = form;

fetch('https://{host}/work-locations/public/api/imports/user-locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/work-locations/public/api/imports/user-locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/work-locations/public/api/imports/user-locations"

	payload := strings.NewReader("-----011000010111000001101001\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/work-locations/public/api/imports/user-locations")
  .header("Authorization", "<authorization>")
  .body("-----011000010111000001101001\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/work-locations/public/api/imports/user-locations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request.body = "-----011000010111000001101001\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "summaryId": "51564472-08cc-4410-94cc-a2b67f77f980"
}

POST

/

work-locations

/

public

/

api

/

imports

/

user-locations

Import user locations

curl --request POST \
  --url https://{host}/work-locations/public/api/imports/user-locations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data'

import requests

url = "https://{host}/work-locations/public/api/imports/user-locations"

payload = "-----011000010111000001101001\r\n-----011000010111000001101001--"
headers = {
    "Content-Type": "multipart/form-data",
    "Authorization": "<authorization>"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();

const options = {method: 'POST', headers: {Authorization: '<authorization>'}};

options.body = form;

fetch('https://{host}/work-locations/public/api/imports/user-locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/work-locations/public/api/imports/user-locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/work-locations/public/api/imports/user-locations"

	payload := strings.NewReader("-----011000010111000001101001\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/work-locations/public/api/imports/user-locations")
  .header("Authorization", "<authorization>")
  .body("-----011000010111000001101001\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/work-locations/public/api/imports/user-locations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request.body = "-----011000010111000001101001\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "summaryId": "51564472-08cc-4410-94cc-a2b67f77f980"
}

Headers

Content-Type

string

required

Multipart boundary MUST be set in the Content-Type header.

Authorization

string

required

API key. Value must be formatted like so: lucca application={api_key}.

Query Parameters

create

boolean

required

Use false to simulate the import and true to create the User Locations. If you simulate you will be able to use analysis and if you create, you could use results.

overrideUserLocations

boolean

required

Use true to replace current User Locations with new one. Use false to create/simulate User Locations just for day without UserLocations.

Body

multipart/form-data

Content of the CSV file to import. Divided by the 'boundary' string set in the Content-Type HTTP header.

Example of a single file request body:

--myBoundary
Content-Disposition: form-data; name="office-import.csv"; filename="office-import.csv"
Content-Type: multipart/form-data

login;workLocationName;areaName;date;position;comment;isDeletion
jdupont;Paris;Service Client;2025/09/18;FullDay;;false
mlefevre;Nantes;B1;2025/09/19;SecondHalf;this is a comment;false
--myBoundary--

The body is of type object.

Response

200 - application/json

OK

summaryId

string<uuid>

Example:

"51564472-08cc-4410-94cc-a2b67f77f980"

Related topics

Import user locations Get import user locations progress Get import user locations analysis Get import user locations results The user-location resource

⌘I