Create Timesheet

curl --request POST \
  --url https://api.bindbee.dev/api/hris/v1/timesheet-entry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Connector-Token: <api-key>' \
  --data '{}'

import requests

url = "https://api.bindbee.dev/api/hris/v1/timesheet-entry"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "X-Connector-Token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-Connector-Token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://api.bindbee.dev/api/hris/v1/timesheet-entry', 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://api.bindbee.dev/api/hris/v1/timesheet-entry",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Connector-Token: <api-key>"
  ],
]);

$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://api.bindbee.dev/api/hris/v1/timesheet-entry"

	payload := strings.NewReader("{}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Connector-Token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bindbee.dev/api/hris/v1/timesheet-entry")
  .header("Authorization", "Bearer <token>")
  .header("X-Connector-Token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bindbee.dev/api/hris/v1/timesheet-entry")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Connector-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

hris

timesheet-entry

Create Timesheet

curl --request POST \
  --url https://api.bindbee.dev/api/hris/v1/timesheet-entry \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Connector-Token: <api-key>' \
  --data '{}'

import requests

url = "https://api.bindbee.dev/api/hris/v1/timesheet-entry"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "X-Connector-Token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-Connector-Token': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://api.bindbee.dev/api/hris/v1/timesheet-entry', 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://api.bindbee.dev/api/hris/v1/timesheet-entry",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Connector-Token: <api-key>"
  ],
]);

$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://api.bindbee.dev/api/hris/v1/timesheet-entry"

	payload := strings.NewReader("{}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Connector-Token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bindbee.dev/api/hris/v1/timesheet-entry")
  .header("Authorization", "Bearer <token>")
  .header("X-Connector-Token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bindbee.dev/api/hris/v1/timesheet-entry")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Connector-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

This endpoint creates a Timesheet Entry in the connected HRIS via Bindbee’s unified Time Sheet Entry model.

Provider-specific behavior

Different HRIS systems can have slightly different requirements and behaviors when creating timesheet entries. Use the accordions below to see details for each provider.

Bamboo HR

When the underlying HRIS is Bamboo HR, a Timesheet Entry can be created using a payload like:

{
  "employee": "019ab506-66a2-7f6e-b8da-09d3579a534e",
  "date": "2025-11-24",
  "start_time": "2025-11-24T08:00:00Z",
  "end_time": "2025-11-24T17:00:00Z"
}

Personio

When the underlying HRIS is Personio, a Timesheet Entry can be created using a payload like:

{
  "employee": "0198e59a-876f-748c-8e38-c56e6246f8aa",
  "break": 8,
  "date": "2025-08-04T08:00:00Z",
  "start_time": "2025-08-04T08:00:00Z",
  "end_time": "2025-08-04T16:00:00Z"
}

Xero

When the underlying HRIS is Xero, a Timesheet Entry can be created using a payload like:

{
  "employee": "0198e59a-876f-748c-8e38-c56e6246f8aa",
  "start_time": "2025-08-04T08:00:00Z",
  "end_time": "2025-08-04T16:00:00Z"
}

QuickBooks

When the underlying HRIS is QuickBooks, a Timesheet Entry can be created using a payload like:

{
  "employee": "0198e59a-876f-748c-8e38-c56e6246f8aa",
  "hours_worked": 8,
  "date": "2025-08-04T08:00:00Z",
  "start_time": "2025-08-04T08:00:00Z",
  "end_time": "2025-08-04T16:00:00Z"
}

Workday

When the underlying HRIS is Workday, a Timesheet Entry can be created using a payload like:

{
  "employee": "019d29f5-07cf-7396-9ae1-34e5b71ad42c",
  "date": "2026-03-26",
  "hours_worked": 7.5,
  "start_time": "2026-03-26T10:00:00Z",
  "end_time": "2026-03-26T17:30:00Z",
  "additional_attributes": {
    "worker_time_block_id": "TEST_BB",
    "time_entry_code_reference_wid": "c20c857a8cf41001aa4db119cb360000",
    "out_reason_reference_id": "Out"
  }
}

out_reason_reference_id must be one of: Break, Meal, or Out.
For time_entry_code_reference_wid, search for All Time Entry Codes in the Workday portal and use the WID of any suitable code from the displayed list.
The selected Time Entry Code must have Units = Hours.
If the selected Time Entry Code has Entry Method = In/Out Only, out_reason_reference_id is required.
If the selected Time Entry Code has Entry Method = Hours Only, out_reason_reference_id must not be passed.

UKG Ready (Beta)

Contact Bindbee Support Team for additional details.

ADP (Beta)

Contact Bindbee Support Team for additional details.

Factorial (Beta)

Contact Bindbee Support Team for additional details.

Authorizations

Authorization

string

header

default:<BINDBEE_API_KEY>

required

Your Bindbee API key, sent as Authorization: Bearer <BINDBEE_API_KEY>. Required on every request.

X-Connector-Token

string

header

default:<CONNECTOR_TOKEN>

required

The connector token for one customer's connection. This is not your Bindbee API key. Required on requests that read or write a single customer's data.

Headers

x-idempotency-key

string | null

Key to guarantee idempotent write execution.

Body

application/json

The body is of type Body · object | null.

Response

Successful Response

API Basics

Platform

HR & Payroll (HRIS)

Recruiting (ATS)

Learning (LMS)

Create Timesheet

Provider-specific behavior

Authorizations

Headers

Body

Response

​Provider-specific behavior

Authorizations

Headers

Body

Response

Provider-specific behavior