Contract passed pre-offer approval | YunoJuno API Documentation

1 { 2 "api_version": "2024-04-10", 3 "event_type": "client.contract.approved", 4 "data": { 5 "object": { 6 "actual_end_date": null, 7 "client": { 8 "client_id": "cl_c1h9vn2ct9ed0emxf5bg0gaq9", 9 "name": "ACME" 10 }, 11 "client_contact": { 12 "client_contact_id": "clct_c2k8wm3du8fe1fnxg6ch1hbr0", 13 "freelancer_id": "fp_c4i6yk5fw6hg3hpyi8ej3jdr2", 14 "custom_fields": [ 15 { 16 "name": "example_field", 17 "value": "ABCD", 18 "metadata": { 19 "example_metadata_1": "Example value 1", 20 "example_metadata_2": "Example value 2", 21 "example_metadata_3": "Example value 3" 22 } 23 } 24 ], 25 "url": "https://app.yunojuno.codes/directory/fp_c4i6yk5fw6hg3hpyi8ej3jdr2/" 26 }, 27 "contract_id": "ct_c3j7xl4ev7gf2goxh7di2icq1", 28 "historical_meta": { 29 "has_previously_accepted_contract": false 30 }, 31 "custom_fields": [ 32 { 33 "name": "example_field", 34 "value": "1234", 35 "metadata": null 36 } 37 ], 38 "description": "Example contract description", 39 "end_date": "2025-09-30", 40 "fee_schedule": { 41 "periods": [ 42 { 43 "effective_from": "2025-07-01", 44 "fees": [ 45 { 46 "currency": "GBP", 47 "name": "Platform Referral Fee", 48 "percentage": "12", 49 "value": "4.80" 50 } 51 ], 52 "total_cost": { 53 "currency": "GBP", 54 "value": "44.80" 55 }, 56 "total_fees": { 57 "currency": "GBP", 58 "value": "4.80" 59 } 60 } 61 ] 62 }, 63 "freelancer": { 64 "date_of_birth": "1991-01-01", 65 "email": "john.smith@example.com", 66 "first_name": "John", 67 "freelancer_id": "fp_c4i6yk5fw6hg3hpyi8ej3jdr2", 68 "full_name": "John Smith", 69 "last_name": "Smith", 70 "legal_name": "John Smith" 71 }, 72 "freelancer_operating_jurisdiction": { 73 "name": "United Kingdom", 74 "country_code": "GB" 75 }, 76 "hirers": [ 77 { 78 "email": "jane.smith@example.com", 79 "first_name": "Jane", 80 "full_name": "Jane Smith", 81 "hirer_id": "hp_c5h5zl6gx5ih4iqzj9fk4kes3", 82 "last_name": "Smith" 83 } 84 ], 85 "job_title": "Example job title", 86 "minutes_in_working_day": 480, 87 "notice_period_days": 7, 88 "rate": { 89 "currency": "GBP", 90 "unit": "HOUR", 91 "value": "40.00" 92 }, 93 "renewal_meta": { 94 "has_subsequent_renewal": false, 95 "initial_contract_id": "ct_c3j7xl4ev7gf2goxh7di2icq1", 96 "is_initial_contract": true, 97 "is_renewal": false, 98 "parent_contract_id": null, 99 "renewal_chain": [ 100 "ct_c3j7xl4ev7gf2goxh7di2icq1" 101 ], 102 "renewal_chain_position": 1 103 }, 104 "spend_request": { 105 "amount": "1000.00", 106 "amount_type": "TOTAL", 107 "currency": "GBP", 108 "custom_fields": [ 109 { 110 "name": "example_field", 111 "value": "123ABCD", 112 "metadata": null 113 } 114 ], 115 "description": "Spend request description", 116 "external_id": "", 117 "spend_request_id": "spreq_c6g4am7hy4ji5jrak0gl5lft4", 118 "title": "Spend request title", 119 "url": "https://app.yunojuno.com/approvals/aprvl_c7h5bn8iz6kj6ksbk1hm6mgu5/" 120 }, 121 "start_date": "2025-07-01", 122 "title": "Contract title", 123 "work_location": "REMOTE", 124 "work_time_type": "FULL_TIME", 125 "url": "https://app.yunojuno.codes/work/contracts/ct_c3j7xl4ev7gf2goxh7di2icq1/" 126 } 127 }, 128 "mode": "live" 129 }

Sent when a contract passes the defined pre-offer approval flow, and is now ready to offer.

Payload

The payload of this webhook request is an object.

contract_idstringRequired<=40 characters

freelancerobjectRequired

The freelancer object. This object represents a freelancer on the YunoJuno platform.

freelancer_operating_jurisdictionobject or nullRequired

The jurisdiction in which the freelancer operates as a business or individual, including the country name and ISO 3166-1 two-character code

clientobjectRequired

The client object. This object represents a client on the YunoJuno platform.

client_contactobjectRequired

The client contact object. This object represents the lifetime relationship between a client and a freelancer on the platform.

hirerslist of objectsRequired

titlestringRequired

job_titlestringRequired

descriptionstringRequired

start_datestringRequiredformat: "date"

end_datestringRequiredformat: "date"

actual_end_datestring or nullRequired

rateobjectRequired

The rate object. This object represents a static amount for a particular rate unit in a particular currency.

work_time_typestringRequired

fee_scheduleobjectRequired

The complete fee schedule for a contract.

notice_period_daysintegerRequired

work_locationstringRequired

minutes_in_working_dayintegerRequired

custom_fieldslist of objectsRequired

spend_requestobjectRequired

The spend request object. This object represents a request to commit spend on the YunoJuno platform.

renewal_metaobjectRequired

historical_metaobjectRequired

urlstringRequired

Response

200

any

Return a 200 status to indicate that the data was received successfully.