Contract cancelled | YunoJuno API Documentation

{
  "api_version": "2024-04-10",
  "event_type": "client.contract.cancelled",
  "data": {
    "object": {
      "client": {
        "client_id": "cl_c1h9vn2ct9ed0emxf5bg0gaq9",
        "name": "ACME"
      },
      "client_contact": {
        "client_contact_id": "clct_c2k8wm3du8fe1fnxg6ch1hbr0",
        "freelancer_id": "fp_c4i6yk5fw6hg3hpyi8ej3jdr2",
        "custom_fields": [
          {
            "name": "example_field",
            "value": "ABCD",
            "metadata": {
              "example_metadata_1": "Example value 1",
              "example_metadata_2": "Example value 2",
              "example_metadata_3": "Example value 3"
            }
          }
        ],
        "url": "https://app.yunojuno.codes/directory/fp_c4i6yk5fw6hg3hpyi8ej3jdr2/"
      },
      "contract_id": "ct_c3j7xl4ev7gf2goxh7di2icq1",
      "historical_meta": {
        "has_previously_accepted_contract": false
      },
      "custom_fields": [
        {
          "name": "example_field",
          "value": "1234"
        }
      ],
      "description": "Example contract description",
      "end_date": "2025-09-30",
      "fee_schedule": {
        "periods": [
          {
            "effective_from": "2025-07-01",
            "fees": [
              {
                "currency": "GBP",
                "name": "Platform Referral Fee",
                "percentage": "12",
                "value": "4.80"
              }
            ],
            "total_cost": {
              "currency": "GBP",
              "value": "44.80"
            },
            "total_fees": {
              "currency": "GBP",
              "value": "4.80"
            }
          }
        ]
      },
      "freelancer": {
        "date_of_birth": "1991-01-01",
        "email": "john.smith@example.com",
        "first_name": "John",
        "freelancer_id": "fp_c4i6yk5fw6hg3hpyi8ej3jdr2",
        "full_name": "John Smith",
        "last_name": "Smith",
        "legal_name": "John Smith"
      },
      "freelancer_operating_jurisdiction": {
        "name": "United Kingdom",
        "country_code": "GB"
      },
      "freelancer_personal_tax_jurisdiction": {
        "name": "United Kingdom",
        "country_code": "GB"
      },
      "hirers": [
        {
          "email": "jane.smith@example.com",
          "first_name": "Jane",
          "full_name": "Jane Smith",
          "hirer_id": "hp_c5h5zl6gx5ih4iqzj9fk4kes3",
          "last_name": "Smith"
        }
      ],
      "job_title": "Example job title",
      "minutes_in_working_day": 480,
      "notice_period_days": 7,
      "rate": {
        "currency": "GBP",
        "unit": "HOUR",
        "value": "40.00"
      },
      "renewal_meta": {
        "has_subsequent_renewal": false,
        "initial_contract_id": "ct_c3j7xl4ev7gf2goxh7di2icq1",
        "is_initial_contract": true,
        "is_renewal": false,
        "renewal_chain": [
          "ct_c3j7xl4ev7gf2goxh7di2icq1"
        ],
        "renewal_chain_position": 1
      },
      "spend_request": {
        "amount": "1000.00",
        "amount_type": "TOTAL",
        "currency": "GBP",
        "custom_fields": [
          {
            "name": "example_field",
            "value": "123ABCD"
          }
        ],
        "description": "Spend request description",
        "external_id": "",
        "spend_request_id": "spreq_c6g4am7hy4ji5jrak0gl5lft4",
        "title": "Spend request title",
        "url": "https://app.yunojuno.com/approvals/aprvl_c7h5bn8iz6kj6ksbk1hm6mgu5/",
        "approval_flow": {
          "approval_flow_id": "apflw_c8i6co9ja7lk7ltcl2in7nhv6",
          "current_approval_step": {
            "approval_step_id": "aprvl_c7h5bn8iz6kj6ksbk1hm6mgu5"
          }
        }
      },
      "start_date": "2025-07-01",
      "title": "Contract title",
      "work_location": "REMOTE",
      "work_time_type": "FULL_TIME",
      "url": "https://app.yunojuno.codes/work/contracts/ct_c3j7xl4ev7gf2goxh7di2icq1/"
    }
  },
  "mode": "live"
}

Sent when an accepted contract is cancelled before the start date.

Payload

The payload of this webhook request is an object.

contract_idstringRequiredRead-only<=40 characters

freelancerobjectRequired

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

freelancer_operating_jurisdictionobject or nullRequiredRead-only

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

freelancer_personal_tax_jurisdictionobject or nullRequiredRead-only

The jurisdiction in which the contractor pays personal taxes, 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 objectsRequiredRead-only

titlestringRequiredRead-only

job_titlestringRequiredRead-only

descriptionstringRequiredRead-only

start_datestringRequiredRead-onlyformat: "date"

end_datestringRequiredRead-onlyformat: "date"

actual_end_datestring or nullRequiredRead-only

rateobjectRequired

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

work_time_typestringRequiredRead-only

fee_scheduleobjectRequired

The complete fee schedule for a contract.

notice_period_daysintegerRequiredRead-only

work_locationstringRequiredRead-only

minutes_in_working_dayintegerRequiredRead-only

custom_fieldslist of objectsRequiredRead-only

pre_offer_approval_flowobject or nullRequiredRead-only

spend_requestobjectRequired

The spend requisition object.

This object represents a request to commit spend on the YunoJuno platform. Spend Requisition was previously named Spend Request in the API documentation; some programmatic names use the old terminology.

renewal_metaobjectRequired

historical_metaobjectRequired

urlstringRequiredRead-only

Response

200

any

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