Skip to main content

Event Payloads

All webhook events share a common structure with resource-specific data.

Event Envelope​

{
  "event": "application.created",
  "event_id": "evt_abc123",
  "created_at": "2025-01-15T10:30:00Z",
  "account_id": 12345,
  "data": {
    // Resource-specific payload
  }
}
FieldDescription
eventEvent type (e.g., application.created)
event_idUnique identifier for this delivery
created_atISO 8601 timestamp
account_idYour Kula account ID
dataResource-specific payload

Event Types​

Candidate Events​

EventDescription
candidate.createdNew candidate added
candidate.updatedCandidate profile updated
candidate.deletedCandidate removed

Application Events​

EventDescription
application.createdNew application submitted
application.updatedApplication updated
application.deletedApplication removed
application.stage_changedApplication moved to new stage
application.rejectedApplication rejected
application.hiredCandidate hired

Job Events​

EventDescription
job.createdNew job created
job.updatedJob updated
job_posting.publishedJob posting went live
job_posting.updatedJob posting updated

Offer Events​

EventDescription
offer.createdNew offer created
offer.updatedOffer updated
offer.approvedOffer approved
offer.deletedOffer removed
offer.acceptedCandidate accepted offer
offer.declinedCandidate declined offer

Common Data Objects​

IdNameObject​

{
  "id": 123,
  "name": "Engineering"
}

UserObject​

{
  "id": 456,
  "name": "Jane Smith",
  "email": "jane@example.com"
}

LocationObject​

{
  "city": { "id": 1, "name": "San Francisco" },
  "state": { "id": 2, "name": "California" },
  "country": { "id": 3, "name": "United States" }
}

Example Payloads​

See the Webhooks API reference for complete payload examples for each event type.