> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.yunojuno.com/client-api/webhook-events/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.yunojuno.com/_mcp/server.

# Webhook Events

This page is the catalog view of all webhook events currently exposed in the YunoJuno Client API.

Use it when you want to answer two questions quickly:

* which event types can I subscribe to?
* which family of events should this endpoint handle?
* when is each event sent?

For the full payload schema and example body of any individual event, use the event pages in the sidebar under this section.

## Client Contacts

| Event                                         | When it is sent                                                                                                                                             |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client.client_contact.created`               | When the client-contact relationship is created for the first time, whether that is a newly invited contractor or someone already on the YunoJuno platform. |
| `client.client_contact.registered`            | When an invited contractor completes account registration and becomes registered on the platform.                                                           |
| `client.client_contact.onboarding_completed`  | When an invited contractor finishes onboarding.                                                                                                             |
| `client.client_contact.custom_fields_updated` | When client-contact custom fields are updated.                                                                                                              |

## Contracts

| Event                           | When it is sent                                                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client.contract.approved`      | When a contract passes its pre-offer approval flow and is ready to be offered.                                                                                      |
| `client.contract.offered`       | When a contract is offered to the contractor after pre-offer approval.                                                                                              |
| `client.contract.revoked`       | When a hirer revokes a contract that is currently in the offered state.                                                                                             |
| `client.contract.accepted`      | When the contractor accepts and signs the contract.                                                                                                                 |
| `client.contract.cancelled`     | When an accepted contract is cancelled before the start date.                                                                                                       |
| `client.contract.notice_served` | When notice is successfully served on a contract and an end date is established.                                                                                    |
| `client.contract.completed`     | When YunoJuno knows the actual end date of a contract, whether that is because notice was given, the contract ended naturally, or it was renewed into a new period. |
| `client.contract.deleted`       | When a contract is permanently deleted.                                                                                                                             |

## Spend Requisitions

| Event                           | When it is sent                                         |
| ------------------------------- | ------------------------------------------------------- |
| `client.spend_request.created`  | When a spend requisition is created for the first time. |
| `client.spend_request.updated`  | When an existing spend requisition is updated.          |
| `client.spend_request.approved` | When an existing spend requisition is approved.         |


## API Docs

- Contracts [Contract passed pre-offer approval](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-approved.md)
- Contracts [Contract offered to freelancer](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-offered.md)
- Contracts [Contract offer revoked by hirer](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-revoked.md)
- Contracts [Contract accepted by freelancer](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-accepted.md)
- Contracts [Contract cancelled](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-cancelled.md)
- Contracts [Notice period served on contract](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-notice-served.md)
- Contracts [Contract end date is known](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-completed.md)
- Contracts [Contract deleted](https://docs.yunojuno.com/client-api/webhook-events/contract-events/client-contract-deleted.md)
- Spend Requisitions [Spend requisition created](https://docs.yunojuno.com/client-api/webhook-events/spend-requisition-events/client-spend-request-created.md)
- Spend Requisitions [Spend requisition updated](https://docs.yunojuno.com/client-api/webhook-events/spend-requisition-events/client-spend-request-updated.md)
- Spend Requisitions [Spend requisition approved](https://docs.yunojuno.com/client-api/webhook-events/spend-requisition-events/client-spend-request-approved.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.yunojuno.com/openapi.json)
- [OpenAPI YAML](https://docs.yunojuno.com/openapi.yaml)