---
updatedAt: 2026-01-05T19:26:51.000Z
agentTools:
  projectIndex: https://developer.breezy.hr/llms.txt
---

# Webhook Events

<br />

Below are all webhook events that Breezy provides. Each event is delivered as a POST request to your configured endpoint with a JSON payload.

All webhook payloads follow this envelope structure:

```json
{
    "_id" : String,
    "type" : String,
    "object" : { ... },
    "creation_date" : Date
}
```

***

## Candidate Added

This webhook is fired when a candidate enters the system. Candidates can enter the system by applying, being sourced, being recruited, or being referred.

```json
{
    "_id" : String,
    "type" : "candidateAdded",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "pipeline_id" : String,
            "all_admins" : Boolean,
            "location" : {
                "name" : String
            }
        },
        "stage" : {
            "id" : String,
            "name" : String
        },
        "entered_stage" : Date,
        "candidate" : {
            "_id" : String,
            "name" : String,
            "email_address" : String,
            "phone_number" : String,
            "profile_photo_url" : String,
            "tags" : Array
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        },
        "source" : {
            "type" : String,
            "id" : String,
            "name" : String
        },
        "external_source" : {
            "id" : String,
            "name" : String
        }
    },
    "creation_date" : Date
}
```

***

## Candidate Deleted

This webhook is fired when a candidate is deleted using the web application. Please note this event is not fired when a candidate is purged via auto-delete configured with GDPR settings enabled.

```json
{
    "_id" : String,
    "type" : "candidateDeleted",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "pipeline_id" : String,
            "all_admins" : Boolean,
            "location" : {
                "name" : String
            }
        },
        "candidate" : {
            "_id" : String,
            "name" : String,
            "email_address" : String,
            "phone_number" : String,
            "profile_photo_url" : String,
            "tags" : Array
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        }
    },
    "creation_date" : Date
}
```

***

## Candidate Status Updated

This webhook is fired when a candidate moves from one stage in a pipeline to another. Please note this event is not fired when a candidate first enters the system.

```json
{
    "_id" : String,
    "type" : "candidateStatusUpdated",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "pipeline_id" : String,
            "all_admins" : Boolean,
            "location" : {
                "name" : String
            }
        },
        "stage_was" : {
            "id" : String,
            "name" : String
        },
        "entered_previous_stage" : Date,
        "stage" : {
            "id" : String,
            "name" : String
        },
        "entered_stage" : Date,
        "time_in_previous_stage" : Number,
        "candidate" : {
            "_id" : String,
            "name" : String,
            "email_address" : String,
            "phone_number" : String,
            "profile_photo_url" : String,
            "tags" : Array
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        },
        "source" : {
            "type" : String,
            "id" : String,
            "name" : String
        },
        "external_source" : {
            "id" : String,
            "name" : String
        }
    },
    "creation_date" : Date
}
```

***

## Position Added

This webhook is fired when a new position is created in the company.

```json
{
    "_id" : String,
    "type" : "companyPositionAdded",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String,
            "state" : String,
            "type" : String,
            "location" : {
                "name" : String,
                "city" : String,
                "state" : String,
                "country" : String
            },
            "department" : String
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        }
    },
    "creation_date" : Date
}
```

***

## Position Updated

This webhook is fired when a position's details are updated (name, description, requirements, etc.). This does not fire when the position state changes - see Position State Updated for that event.

```json
{
    "_id" : String,
    "type" : "companyPositionUpdated",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String,
            "state" : String,
            "type" : String,
            "location" : {
                "name" : String,
                "city" : String,
                "state" : String,
                "country" : String
            },
            "department" : String
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        }
    },
    "creation_date" : Date
}
```

***

## Position Deleted

This webhook is fired when a position is deleted from the company.

```json
{
    "_id" : String,
    "type" : "companyPositionDeleted",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String,
            "state" : String,
            "type" : String,
            "location" : {
                "name" : String,
                "city" : String,
                "state" : String,
                "country" : String
            },
            "department" : String
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        }
    },
    "creation_date" : Date
}
```

***

## Position State Updated

This webhook is fired when a position's state changes (e.g., from draft to published, or published to closed).

```json
{
    "_id" : String,
    "type" : "companyPositionStateUpdated",
    "object" : {
        "company" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String
        },
        "position" : {
            "_id" : String,
            "name" : String,
            "friendly_id" : String,
            "state" : String,
            "type" : String,
            "location" : {
                "name" : String,
                "city" : String,
                "state" : String,
                "country" : String
            },
            "department" : String
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        },
        "state_is" : String,
        "state_was" : String
    },
    "creation_date" : Date
}
```

***

## Team Note Posted

This webhook is fired when a team member posts a note in the candidate's team discussion.

```json
{
    "_id" : String,
    "type" : "companyNotePosted",
    "object" : {
        "company_id" : String,
        "position" : {
            "_id" : String,
            "name" : String,
            "pipeline_id" : String,
            "all_admins" : Boolean,
            "location" : {
                "name" : String
            }
        },
        "candidate" : {
            "_id" : String,
            "name" : String,
            "email_address" : String,
            "phone_number" : String,
            "profile_photo_url" : String,
            "tags" : Array
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        },
        "body" : String,
        "attachments" : Array
    },
    "creation_date" : Date
}
```

***

## Team Note Updated

This webhook is fired when a team discussion note is edited.

```json
{
    "_id" : String,
    "type" : "companyNoteUpdated",
    "object" : {
        "note_id" : String,
        "company_id" : String,
        "position" : {
            "_id" : String,
            "name" : String,
            "pipeline_id" : String,
            "all_admins" : Boolean,
            "location" : {
                "name" : String
            }
        },
        "candidate" : {
            "_id" : String,
            "name" : String,
            "email_address" : String,
            "phone_number" : String,
            "profile_photo_url" : String,
            "tags" : Array
        },
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        },
        "body" : String,
        "attachments" : Array
    },
    "creation_date" : Date
}
```

***

## Team Note Deleted

This webhook is fired when a team discussion note is deleted.

```json
{
    "_id" : String,
    "type" : "companyNoteDeleted",
    "object" : {
        "note_id" : String,
        "company_id" : String,
        "acting_user" : {
            "_id" : String,
            "email_address" : String,
            "name" : String,
            "profile_photo_url" : String
        }
    },
    "creation_date" : Date
}
```

<br />