curl -X POST https://acme.orgo.space/api/v1/contract_users \
-H "Api-Token: $ORGO_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contract": "/api/v1/contracts/9",
"user": "/api/v1/users/42",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14"
}'await fetch("https://acme.orgo.space/api/v1/contract_users", {
method: "POST",
headers: {
"Api-Token": process.env.ORGO_API_TOKEN,
"Content-Type": "application/json",
},
body: JSON.stringify({
contract: "/api/v1/contracts/9",
user: "/api/v1/users/42",
validityStartDate: "2026-01-15",
validityEndDate: "2027-01-14",
}),
});
$client->post('/api/v1/contract_users', [
'headers' => ['Api-Token' => getenv('ORGO_API_TOKEN')],
'json' => [
'contract' => '/api/v1/contracts/9',
'user' => '/api/v1/users/42',
'validityStartDate' => '2026-01-15',
'validityEndDate' => '2027-01-14',
],
]);
import requests
url = "https://app.orgo.space/api/v1/contract_users"
payload = {
"contract": "/api/v1/contracts/9",
"user": "/api/v1/users/42",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/contract_users"
payload := strings.NewReader("{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-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://app.orgo.space/api/v1/contract_users")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contract_users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}"
response = http.request(request)
puts response.read_body{
"id": 63,
"contract": {
"id": 9,
"name": "Member Agreement 2026"
},
"user": {
"id": 42,
"fullName": "James Patterson"
},
"status": "UNSIGNED",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14",
"dateCreated": "2026-01-15T10:30:00+00:00"
}Create a contract user
Assigns a contract to a user or contact. Requires either a user or contact reference and a contract reference. Validates tenant isolation across all linked entities. Populates the placeholder map from the contract template and resolves custom field and placeholder values. HR_LOCAL or HR_TENANT permission is required when assigning to another user.
curl -X POST https://acme.orgo.space/api/v1/contract_users \
-H "Api-Token: $ORGO_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contract": "/api/v1/contracts/9",
"user": "/api/v1/users/42",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14"
}'await fetch("https://acme.orgo.space/api/v1/contract_users", {
method: "POST",
headers: {
"Api-Token": process.env.ORGO_API_TOKEN,
"Content-Type": "application/json",
},
body: JSON.stringify({
contract: "/api/v1/contracts/9",
user: "/api/v1/users/42",
validityStartDate: "2026-01-15",
validityEndDate: "2027-01-14",
}),
});
$client->post('/api/v1/contract_users', [
'headers' => ['Api-Token' => getenv('ORGO_API_TOKEN')],
'json' => [
'contract' => '/api/v1/contracts/9',
'user' => '/api/v1/users/42',
'validityStartDate' => '2026-01-15',
'validityEndDate' => '2027-01-14',
],
]);
import requests
url = "https://app.orgo.space/api/v1/contract_users"
payload = {
"contract": "/api/v1/contracts/9",
"user": "/api/v1/users/42",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/contract_users"
payload := strings.NewReader("{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-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://app.orgo.space/api/v1/contract_users")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contract_users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contract\": \"/api/v1/contracts/9\",\n \"user\": \"/api/v1/users/42\",\n \"validityStartDate\": \"2026-01-15\",\n \"validityEndDate\": \"2027-01-14\"\n}"
response = http.request(request)
puts response.read_body{
"id": 63,
"contract": {
"id": 9,
"name": "Member Agreement 2026"
},
"user": {
"id": 42,
"fullName": "James Patterson"
},
"status": "UNSIGNED",
"validityStartDate": "2026-01-15",
"validityEndDate": "2027-01-14",
"dateCreated": "2026-01-15T10:30:00+00:00"
}Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Body
The new ContractUser resource
Response
ContractUser resource created
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

