> This page is for API, version 2026-01-01 (Stable) (default). > For other versions, use one of these documentation indexes: > - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.deel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server. # Set salary split PATCH https://api.letsdeel.com/rest/gp/contracts/{contract_id}/banks/settings Content-Type: application/json Use this when a worker has multiple bank accounts under a single Global Payroll contract and you need to control what portion of their salary goes to each. Sets how the employee's salary is split across that contract's bank accounts, independently of the worker's other contracts. Each entry gives the percentage (0–100) paid to one account, and the percentages across the contract's accounts must add up to 100. **Token scopes**: `people:write` Reference: https://developer.deel.com/api/reference/endpoints/global-payroll/set-gp-contract-bank-settings-v-2026-09-17 ## Authentication - `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Path parameters - `contract_id` (string, required) — Unique identifier for a contract. ### Body (application/json) This endpoint expects an object. - `data` (GpContractsContractIdBanksSettingsPatchRequestBodyContentApplicationJsonSchemaData, required) ## Response ### 200 Successful operation. - `data` (list of GpContractsContractIdBanksSettingsPatchResponsesContentApplicationJsonSchemaDataItems, required) — The resulting split per account after the update. ## Errors ### 400 Bad Request Error Invalid request parameters. - `errors` (list of GpContractsContractIdBanksSettingsPatchResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 401 Unauthorized Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 403 Forbidden Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 404 Not Found Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 500 Internal Server Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ## Types ### GpContractsContractIdBanksSettingsPatchRequestBodyContentApplicationJsonSchemaData - `settings` (list of GpContractsContractIdBanksSettingsPatchRequestBodyContentApplicationJsonSchemaDataSettingsItems, required) — The salary split across the contract's bank accounts. Percentages must add up to 100. ### GpContractsContractIdBanksSettingsPatchResponsesContentApplicationJsonSchemaDataItems - `id` (string, required) — Identifier of the bank account. - `funds_distribution` (double, required) — Percentage (0–100) of the salary paid to this account. ### GpContractsContractIdBanksSettingsPatchResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, optional) — Machine-readable error code. - `message` (string, optional) — Human-readable explanation. ### ApiErrorRequest - `method` (string, optional) — The HTTP method of the failed request - `url` (string, optional) — The relative URL of the failed request - `status` (double, optional) — The status code of the response - `api_req_id` (string, optional) — The request ID of the failed request - `docs` (string, optional) — A link to the official documentation for the requested endpoint resource - `source` (string, optional) — The source handler which produced the returned error - `code` (double, optional) — The code of the source handler which produced the returned error ### ApiError - `message` (string, optional) — A description of the returned error - `path` (string, optional) — The JSON path where input validation failed ### GpContractsContractIdBanksSettingsPatchRequestBodyContentApplicationJsonSchemaDataSettingsItems - `bank_id` (string, required) — Identifier of the bank account (as returned by GET /banks). - `funds_distribution` (double, required) — Percentage (0–100) of the salary paid to this account. ## Examples **Request** ```json { "data": { "settings": [ { "bank_id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7", "funds_distribution": 60 }, { "bank_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "funds_distribution": 40 } ] } } ``` **Response** ```json { "data": [ { "id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7", "funds_distribution": 60 } ] } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings" payload = { "data": { "settings": [ { "bank_id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7", "funds_distribution": 60 }, { "bank_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "funds_distribution": 40 } ] } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"data":{"settings":[{"bank_id":"c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7","funds_distribution":60},{"bank_id":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","funds_distribution":40}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings" payload := strings.NewReader("{\n \"data\": {\n \"settings\": [\n {\n \"bank_id\": \"c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7\",\n \"funds_distribution\": 60\n },\n {\n \"bank_id\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"funds_distribution\": 40\n }\n ]\n }\n}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"data\": {\n \"settings\": [\n {\n \"bank_id\": \"c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7\",\n \"funds_distribution\": 60\n },\n {\n \"bank_id\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"funds_distribution\": 40\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"data\": {\n \"settings\": [\n {\n \"bank_id\": \"c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7\",\n \"funds_distribution\": 60\n },\n {\n \"bank_id\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"funds_distribution\": 40\n }\n ]\n }\n}") .asString(); ``` ```php request('PATCH', 'https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings', [ 'body' => '{ "data": { "settings": [ { "bank_id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7", "funds_distribution": 60 }, { "bank_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "funds_distribution": 40 } ] } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings"); var request = new RestRequest(Method.PATCH); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"data\": {\n \"settings\": [\n {\n \"bank_id\": \"c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7\",\n \"funds_distribution\": 60\n },\n {\n \"bank_id\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"funds_distribution\": 40\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["data": ["settings": [ [ "bank_id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7", "funds_distribution": 60 ], [ "bank_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "funds_distribution": 40 ] ]]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks/settings")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```