> ## Documentation Index > Fetch the complete documentation index at: https://exsited.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a labour profile > Creates a labour profile with its sessions, prices and availability. Send the profile under `labour_profile` with at least one entry in `labour_profile_sessions`; each session has its dates, `labour_profile_session_prices` and `labour_profile_session_availability`. A profile without sessions is refused with `400`. The new profile comes back under `labour_profile`. > [!NOTE] > > The SDK samples get their client from credentials your app registers once when it starts, as shown in [Authentication](https://exsited.mintlify.site/authentication.md#set-up-a-client). To try the call here, click **Try it**, set `host` to your Exsited API host name and paste an access token from [Get an access token](https://exsited.mintlify.site/api-reference/authentication/get-an-access-token.md). To send a raw JSON body instead of filling in fields, copy the cURL sample and edit its `-d` payload. ## OpenAPI ````yaml POST /labour_profiles openapi: 3.1.0 info: title: Exsited API version: v4 servers: - url: https://{host}/api/v4 variables: host: default: your-api-host.example.com description: Your Exsited API host name, without https://. security: - bearerAuth: [] tags: - name: Authentication - name: Accounts - name: Account emails - name: Account groups - name: Communications - name: Communication profiles - name: Orders - name: Quote orders - name: Express - name: Usages - name: Sales reps - name: Gift certificates - name: Invoices - name: Pro-forma invoices - name: Payments - name: Refunds - name: Credit notes - name: Credit note applications - name: Reconciliations - name: Items - name: Inventory adjustments - name: Units of measurement - name: Zones - name: Shipping packages - name: Shipping rules - name: Fulfillment profiles - name: Fulfillment terms - name: Item fulfillments - name: Item receipts - name: Bookings - name: Rental assets - name: Return merchandise authorisations - name: Purchase orders - name: Purchase invoices - name: Purchase payments - name: Purchase refunds - name: Purchase credit notes - name: Purchase credit note applications - name: Purchase express - name: Return vendor authorizations - name: ABA files - name: Receive terms - name: Labours - name: Tasks - name: Timesheets - name: Milestones - name: Employees - name: Departments - name: Designations - name: Teams - name: Time periods - name: Workflows - name: Workflow settings - name: Events - name: Custom events - name: System events - name: Approvals - name: Approval profiles - name: Approval user groups - name: Alerts - name: Alert responsibility settings - name: Alert responsibilities - name: Action scripts - name: Note groups - name: Note attachments - name: Instance settings - name: Accounting codes - name: Additional codes - name: Billing periods - name: Charging periods - name: Pricing periods - name: Invoice terms - name: Days of the month - name: Countries - name: Salutations - name: Document templates - name: Email templates - name: Roles - name: Operators - name: Operator groups - name: User settings - name: Custom attributes - name: Custom components - name: Custom features - name: Custom fields - name: Custom forms - name: Attribute attachments - name: Portal - name: Integration connections - name: External databases - name: Reports - name: Applications - name: Organisation - name: Child organisations - name: Webhooks paths: /labour_profiles: post: tags: - Labours summary: Create a labour profile description: >- Send the profile under `labour_profile` with at least one entry in `labour_profile_sessions`; each session has its dates, `labour_profile_session_prices` and `labour_profile_session_availability`. A profile without sessions is refused with `400`. The new profile comes back under `labour_profile`. operationId: labours_create_labour_profile parameters: [] requestBody: required: true content: application/json: schema: type: object properties: labour_profile: type: object properties: name: type: string display_name: type: string currency: type: string description: The currency code, such as `AUD`. tax_inclusive: type: boolean labour_profile_sessions: type: array description: >- At least one session; a profile without sessions is refused with `400`. items: type: object properties: name: type: string start_date: type: string description: The first day of the session, as `YYYY-MM-DD`. end_date: type: string description: The last day of the session, as `YYYY-MM-DD`. labour_profile_session_prices: type: array items: type: object properties: price: type: number enabled_pro_rata: type: boolean price_type: type: string description: How the price applies, such as `HOURLY`. labour_profile_session_availability: type: array items: type: object properties: preferred_day: type: string description: >- The day of the week, in lower case, such as `monday`. start_time: type: string description: The start time, as `HH:MM`. end_time: type: string description: The end time, as `HH:MM`. available: type: boolean required: - labour_profile_sessions required: - labour_profile example: labour_profile: name: Standard technician display_name: Standard technician currency: AUD tax_inclusive: false labour_profile_sessions: - name: Business hours start_date: '2026-11-02' end_date: '2027-11-02' labour_profile_session_prices: - price: 10 enabled_pro_rata: false price_type: HOURLY labour_profile_session_availability: - preferred_day: monday start_time: '08:00' end_time: '18:00' available: true - preferred_day: tuesday start_time: '08:00' end_time: '18:00' available: true - preferred_day: wednesday start_time: '08:00' end_time: '18:00' available: true - preferred_day: thursday start_time: '08:00' end_time: '18:00' available: true - preferred_day: friday start_time: '08:00' end_time: '18:00' available: true - preferred_day: saturday start_time: '08:00' end_time: '18:00' available: true - preferred_day: sunday start_time: '08:00' end_time: '18:00' available: true responses: '201': description: The new labour profile, under `labour_profile`. content: application/json: schema: $ref: '#/components/schemas/LabourProfileViewResponse' '400': description: The profile has no sessions. content: application/json: schema: $ref: '#/components/schemas/Error' x-codeSamples: - lang: bash label: cURL source: |- curl -X POST "$EXSITED_BASE_URL/api/v4/labour_profiles" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "labour_profile": { "name": "Standard technician", "display_name": "Standard technician", "currency": "AUD", "tax_inclusive": false, "labour_profile_sessions": [ { "name": "Business hours", "start_date": "2026-11-02", "end_date": "2027-11-02", "labour_profile_session_prices": [ { "price": 10, "enabled_pro_rata": false, "price_type": "HOURLY" } ], "labour_profile_session_availability": [ { "preferred_day": "monday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "tuesday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "wednesday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "thursday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "friday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "saturday", "start_time": "08:00", "end_time": "18:00", "available": true }, { "preferred_day": "sunday", "start_time": "08:00", "end_time": "18:00", "available": true } ] } ] } }' - lang: python label: Python source: | from exsited import build_client client = build_client() response = client.labours.create_labour_profile( { "labour_profile": { "name": "Standard technician", "display_name": "Standard technician", "currency": "AUD", "tax_inclusive": False, "labour_profile_sessions": [ { "name": "Business hours", "start_date": "2026-11-02", "end_date": "2027-11-02", "labour_profile_session_prices": [ {"price": 10, "enabled_pro_rata": False, "price_type": "HOURLY"} ], "labour_profile_session_availability": [ { "preferred_day": "monday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "tuesday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "wednesday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "thursday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "friday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "saturday", "start_time": "08:00", "end_time": "18:00", "available": True, }, { "preferred_day": "sunday", "start_time": "08:00", "end_time": "18:00", "available": True, }, ], } ], } } ) print(response.data) - lang: javascript label: JavaScript source: | import {buildClient} from 'exsited'; const client = await buildClient(); const response = await client.labours.createLabourProfile({ labour_profile: { name: 'Standard technician', display_name: 'Standard technician', currency: 'AUD', tax_inclusive: false, labour_profile_sessions: [ { name: 'Business hours', start_date: '2026-11-02', end_date: '2027-11-02', labour_profile_session_prices: [{price: 10, enabled_pro_rata: false, price_type: 'HOURLY'}], labour_profile_session_availability: [ {preferred_day: 'monday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'tuesday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'wednesday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'thursday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'friday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'saturday', start_time: '08:00', end_time: '18:00', available: true}, {preferred_day: 'sunday', start_time: '08:00', end_time: '18:00', available: true}, ], }, ], }, }); console.log(response.data); - lang: php label: PHP source: | use Exsited\Client\ClientRegistry; $client = ClientRegistry::buildClient(); $response = $client->labours->createLabourProfile([ 'labour_profile' => [ 'name' => 'Standard technician', 'display_name' => 'Standard technician', 'currency' => 'AUD', 'tax_inclusive' => false, 'labour_profile_sessions' => [ [ 'name' => 'Business hours', 'start_date' => '2026-11-02', 'end_date' => '2027-11-02', 'labour_profile_session_prices' => [ ['price' => 10, 'enabled_pro_rata' => false, 'price_type' => 'HOURLY'], ], 'labour_profile_session_availability' => [ [ 'preferred_day' => 'monday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'tuesday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'wednesday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'thursday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'friday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'saturday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], [ 'preferred_day' => 'sunday', 'start_time' => '08:00', 'end_time' => '18:00', 'available' => true, ], ], ], ], ], ]); print_r($response->data); - lang: java label: Java source: > import com.exsited.client.ApiResponse; import com.exsited.client.ClientRegistry; import com.exsited.client.ExsitedClient; import com.exsited.resources.labours.labours_dto.LaboursDto.LabourProfileView; import java.util.List; import java.util.Map; ExsitedClient client = ClientRegistry.buildClient(); ApiResponse response = client.labours().createLabourProfile( Map.of( "labour_profile", Map.of( "name", "Standard technician", "display_name", "Standard technician", "currency", "AUD", "tax_inclusive", false, "labour_profile_sessions", List.of( Map.of( "name", "Business hours", "start_date", "2026-11-02", "end_date", "2027-11-02", "labour_profile_session_prices", List.of( Map.of( "price", 10, "enabled_pro_rata", false, "price_type", "HOURLY")), "labour_profile_session_availability", List.of( Map.of( "preferred_day", "monday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "tuesday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "wednesday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "thursday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "friday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "saturday", "start_time", "08:00", "end_time", "18:00", "available", true), Map.of( "preferred_day", "sunday", "start_time", "08:00", "end_time", "18:00", "available", true))))))); System.out.println(response.getMap()); - lang: csharp label: .NET source: > using Exsited.Client; await using var client = ExsitedClient.BuildClient(); var response = await client.Labours.CreateLabourProfileAsync(new Dictionary { ["labour_profile"] = new Dictionary { ["name"] = "Standard technician", ["display_name"] = "Standard technician", ["currency"] = "AUD", ["tax_inclusive"] = false, ["labour_profile_sessions"] = new List { new Dictionary { ["name"] = "Business hours", ["start_date"] = "2026-11-02", ["end_date"] = "2027-11-02", ["labour_profile_session_prices"] = new List { new Dictionary { ["price"] = 10, ["enabled_pro_rata"] = false, ["price_type"] = "HOURLY", }, }, ["labour_profile_session_availability"] = new List { new Dictionary { ["preferred_day"] = "monday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "tuesday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "wednesday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "thursday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "friday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "saturday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, new Dictionary { ["preferred_day"] = "sunday", ["start_time"] = "08:00", ["end_time"] = "18:00", ["available"] = true, }, }, }, }, }, }); Console.WriteLine(response.Json); - lang: dart label: Dart source: | import 'package:exsited/exsited.dart'; final client = buildClient(); final response = await client.labours.createLabourProfile({ 'labour_profile': { 'name': 'Standard technician', 'display_name': 'Standard technician', 'currency': 'AUD', 'tax_inclusive': false, 'labour_profile_sessions': [ { 'name': 'Business hours', 'start_date': '2026-11-02', 'end_date': '2027-11-02', 'labour_profile_session_prices': [ {'price': 10, 'enabled_pro_rata': false, 'price_type': 'HOURLY'}, ], 'labour_profile_session_availability': [ { 'preferred_day': 'monday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'tuesday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'wednesday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'thursday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'friday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'saturday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, { 'preferred_day': 'sunday', 'start_time': '08:00', 'end_time': '18:00', 'available': true, }, ], }, ], }, }); print(response.map); - lang: go label: Go source: "import (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\texsited \"github.com/exsited/exsited-sdk-go/v4\"\n)\n\nclient, err := exsited.BuildClient(nil)\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer client.Close()\n\nresponse, err := client.Labours().CreateLabourProfile(context.Background(), map[string]any{\n\t\"labour_profile\": map[string]any{\n\t\t\"name\": \"Standard technician\",\n\t\t\"display_name\": \"Standard technician\",\n\t\t\"currency\": \"AUD\",\n\t\t\"tax_inclusive\": false,\n\t\t\"labour_profile_sessions\": []any{\n\t\t\tmap[string]any{\n\t\t\t\t\"name\": \"Business hours\",\n\t\t\t\t\"start_date\": \"2026-11-02\",\n\t\t\t\t\"end_date\": \"2027-11-02\",\n\t\t\t\t\"labour_profile_session_prices\": []any{\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"price\": 10,\n\t\t\t\t\t\t\"enabled_pro_rata\": false,\n\t\t\t\t\t\t\"price_type\": \"HOURLY\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t\"labour_profile_session_availability\": []any{\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"monday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"tuesday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"wednesday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"thursday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"friday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"saturday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t\tmap[string]any{\n\t\t\t\t\t\t\"preferred_day\": \"sunday\",\n\t\t\t\t\t\t\"start_time\": \"08:00\",\n\t\t\t\t\t\t\"end_time\": \"18:00\",\n\t\t\t\t\t\t\"available\": true,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t},\n}, nil)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Println(response.Map)\n" components: schemas: LabourProfileViewResponse: type: object properties: labour_profile: $ref: '#/components/schemas/LabourProfileView' Error: type: object description: Every failed call returns this body. properties: object: type: string description: Always `error`. request_id: type: string description: Quote this to support. status: type: integer description: The HTTP status. code: type: string description: What went wrong, such as `validation_error`. message: type: string description: A short description of the problem. doc_url: type: string description: A link to more about this error. errors: type: array description: One entry per field that failed. items: type: object properties: field: type: string code: type: string message: type: string doc_url: type: string LabourProfileView: type: object properties: activity_logs: type: array created_by: $ref: '#/components/schemas/LabourProfileViewCreatedBy' created_on: type: string currency: $ref: '#/components/schemas/LabourProfileViewCurrency' display_name: type: string href: type: string id: type: string labours: type: array items: $ref: '#/components/schemas/LabourProfileViewRow' last_updated_by: $ref: '#/components/schemas/LabourProfileViewLastUpdatedBy' last_updated_on: type: string max_booking_limit: type: integer name: type: string object: type: string sessions: type: array items: $ref: '#/components/schemas/LabourProfileViewSession' status: type: string tax: $ref: '#/components/schemas/LabourProfileViewTax' tax_inclusive: type: boolean version: type: integer LabourProfileViewCreatedBy: type: object properties: object: type: string id: type: string name: type: string href: type: string LabourProfileViewCurrency: type: object properties: code: type: string href: type: string id: type: string name: type: string object: type: string LabourProfileViewRow: type: object properties: code: type: string href: type: string id: type: string name: type: string object: type: string LabourProfileViewLastUpdatedBy: type: object properties: object: type: string id: type: string name: type: string href: type: string LabourProfileViewSession: type: object properties: allow_overtime: type: boolean availability: type: array items: $ref: '#/components/schemas/LabourProfileViewSessionAvailability' end_date: type: string href: type: string id: type: string name: type: string object: type: string prices: type: array items: $ref: '#/components/schemas/LabourProfileViewSessionPrice' start_date: type: string status: type: string working_hours: type: array items: $ref: '#/components/schemas/LabourProfileViewSessionWorkingHour' LabourProfileViewTax: type: object properties: href: type: string id: type: string object: type: string LabourProfileViewSessionAvailability: type: object properties: available: type: boolean end_time: type: string id: type: string object: type: string preferred_day: type: string start_time: type: string status: type: string LabourProfileViewSessionPrice: type: object properties: enabled_pro_rata: type: boolean hours: type: array items: $ref: '#/components/schemas/LabourProfileViewSessionPriceHour' id: type: string object: type: string peak_hourly: type: array price: type: number price_type: type: string pricing_level: $ref: '#/components/schemas/LabourProfileViewSessionPricePricingLevel' status: type: string LabourProfileViewSessionWorkingHour: type: object properties: end_time: type: string id: type: string object: type: string start_time: type: string status: type: string LabourProfileViewSessionPriceHour: type: object properties: end_time: type: string id: type: string object: type: string price: type: number start_time: type: string status: type: string LabourProfileViewSessionPricePricingLevel: type: object properties: object: type: string id: type: string name: type: string href: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: >- An access token from `POST /api/v4/oauth2/token`. The SDKs get and renew it for you. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.