curl --request POST \
--url https://app.orgo.space/api/v1/contract_users/mark_as_signed \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"contract": "/api/v1/contracts/1",
"user": "/api/v1/users/1",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"html": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": "/api/v1/contacts/1",
"placeholderMap": [
"string"
]
}
EOFimport requests
url = "https://app.orgo.space/api/v1/contract_users/mark_as_signed"
payload = {
"contract": "/api/v1/contracts/1",
"user": "/api/v1/users/1",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"html": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": "/api/v1/contacts/1",
"placeholderMap": ["string"]
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contract: '/api/v1/contracts/1',
user: '/api/v1/users/1',
dateValidityEnd: '2026-01-15T10:30:00+00:00',
html: '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
dateValidityStart: '2026-01-15T10:30:00+00:00',
contact: '/api/v1/contacts/1',
placeholderMap: ['string']
})
};
fetch('https://app.orgo.space/api/v1/contract_users/mark_as_signed', 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://app.orgo.space/api/v1/contract_users/mark_as_signed",
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([
'contract' => '/api/v1/contracts/1',
'user' => '/api/v1/users/1',
'dateValidityEnd' => '2026-01-15T10:30:00+00:00',
'html' => '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
'dateValidityStart' => '2026-01-15T10:30:00+00:00',
'contact' => '/api/v1/contacts/1',
'placeholderMap' => [
'string'
]
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$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://app.orgo.space/api/v1/contract_users/mark_as_signed"
payload := strings.NewReader("{\n \"contract\": \"/api/v1/contracts/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\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/mark_as_signed")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract\": \"/api/v1/contracts/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contract_users/mark_as_signed")
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/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"contract": {
"id": 42,
"name": "Boston Chapter",
"isInfiniteDuration": true,
"yearDuration": 60,
"monthDuration": 60,
"hasSignature": true,
"hasUpload": true,
"contractHash": "a3f8b2c4d6e8f1a3b5c7d9e1f3a5b7c9",
"enableSignatureCancellation": true,
"required": true,
"hasAdminSignature": true,
"unit": "/api/v1/units/1",
"displayInProfile": true,
"defaultSignature": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"hasDefaultSignature": true,
"useDefaultSignatureAsPreSigned": true
},
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"townCurrent": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"mapLatitude": "42.3601",
"mapLongitude": "-71.0589",
"mapPlaceName": "Boston Common",
"feeTenantProductPrice": {
"id": 42,
"price": 50
},
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"isLocked": true,
"isApproved": true,
"media": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"signature": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"dateSignature": "2026-01-15T10:30:00+00:00",
"contractHash": "a3f8b2c4d6e8f1a3b5c7d9e1f3a5b7c9",
"canceledBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"townCurrent": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"mapLatitude": "42.3601",
"mapLongitude": "-71.0589",
"mapPlaceName": "Boston Common",
"feeTenantProductPrice": {
"id": 42,
"price": 50
},
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"dateCanceled": "2026-01-15T10:30:00+00:00",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": {
"id": 42,
"name": "Boston Chapter",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"town": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson"
},
"placeholderMap": [
"string"
],
"signatureAdmin": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"status": "ACTIVE",
"contractNumber": 42
}Mark contract users as signed
Manually marks a contract-user as fully signed without requiring actual signatures. Sets status to COMPLETE, locks the record, uses the validity start date as the signature date, and records the admin who performed the action. Validates that end date is after start date and enforces tenant isolation. Requires HR_TENANT permission.
curl --request POST \
--url https://app.orgo.space/api/v1/contract_users/mark_as_signed \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"contract": "/api/v1/contracts/1",
"user": "/api/v1/users/1",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"html": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": "/api/v1/contacts/1",
"placeholderMap": [
"string"
]
}
EOFimport requests
url = "https://app.orgo.space/api/v1/contract_users/mark_as_signed"
payload = {
"contract": "/api/v1/contracts/1",
"user": "/api/v1/users/1",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"html": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": "/api/v1/contacts/1",
"placeholderMap": ["string"]
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contract: '/api/v1/contracts/1',
user: '/api/v1/users/1',
dateValidityEnd: '2026-01-15T10:30:00+00:00',
html: '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
dateValidityStart: '2026-01-15T10:30:00+00:00',
contact: '/api/v1/contacts/1',
placeholderMap: ['string']
})
};
fetch('https://app.orgo.space/api/v1/contract_users/mark_as_signed', 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://app.orgo.space/api/v1/contract_users/mark_as_signed",
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([
'contract' => '/api/v1/contracts/1',
'user' => '/api/v1/users/1',
'dateValidityEnd' => '2026-01-15T10:30:00+00:00',
'html' => '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
'dateValidityStart' => '2026-01-15T10:30:00+00:00',
'contact' => '/api/v1/contacts/1',
'placeholderMap' => [
'string'
]
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$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://app.orgo.space/api/v1/contract_users/mark_as_signed"
payload := strings.NewReader("{\n \"contract\": \"/api/v1/contracts/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\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/mark_as_signed")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contract\": \"/api/v1/contracts/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contract_users/mark_as_signed")
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/1\",\n \"user\": \"/api/v1/users/1\",\n \"dateValidityEnd\": \"2026-01-15T10:30:00+00:00\",\n \"html\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"dateValidityStart\": \"2026-01-15T10:30:00+00:00\",\n \"contact\": \"/api/v1/contacts/1\",\n \"placeholderMap\": [\n \"string\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"contract": {
"id": 42,
"name": "Boston Chapter",
"isInfiniteDuration": true,
"yearDuration": 60,
"monthDuration": 60,
"hasSignature": true,
"hasUpload": true,
"contractHash": "a3f8b2c4d6e8f1a3b5c7d9e1f3a5b7c9",
"enableSignatureCancellation": true,
"required": true,
"hasAdminSignature": true,
"unit": "/api/v1/units/1",
"displayInProfile": true,
"defaultSignature": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"hasDefaultSignature": true,
"useDefaultSignatureAsPreSigned": true
},
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"townCurrent": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"mapLatitude": "42.3601",
"mapLongitude": "-71.0589",
"mapPlaceName": "Boston Common",
"feeTenantProductPrice": {
"id": 42,
"price": 50
},
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"isLocked": true,
"isApproved": true,
"media": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"signature": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"dateSignature": "2026-01-15T10:30:00+00:00",
"contractHash": "a3f8b2c4d6e8f1a3b5c7d9e1f3a5b7c9",
"canceledBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"townCurrent": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"mapLatitude": "42.3601",
"mapLongitude": "-71.0589",
"mapPlaceName": "Boston Common",
"feeTenantProductPrice": {
"id": 42,
"price": 50
},
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"dateCanceled": "2026-01-15T10:30:00+00:00",
"dateValidityEnd": "2026-01-15T10:30:00+00:00",
"dateValidityStart": "2026-01-15T10:30:00+00:00",
"contact": {
"id": 42,
"name": "Boston Chapter",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"town": {
"id": 42,
"name": "Boston Chapter",
"nameWithCounty": "Boston Chapter"
},
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
{
"id": 42,
"field": "/api/v1/custom_fields/1",
"value": "Vegetarian",
"media": "/api/v1/medias/1"
}
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson"
},
"placeholderMap": [
"string"
],
"signatureAdmin": {
"id": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"originalName": "Boston Chapter"
},
"status": "ACTIVE",
"contractNumber": 42
}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
"/api/v1/contracts/1"
"/api/v1/users/1"
"/api/v1/contacts/1"
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

