Candidate Updated - Talview Docs

For general webhook concepts like bubble-up behavior, payload visibility rules, and versioned snapshots, see Webhook Concepts.

Description

This event is triggered when a candidate’s profile is updated, or when any subordinate record changes (education, experience, attachments, etc.) — all changes bubble up to the candidate root.

Integration Details

Subscription Key: can.candidate.updated
Use Case: Keep candidate data in sync with your ATS or external systems.
Related Events: can.candidate.created

Trigger

Event Type: can_candidate_updated
Source: Update of a record in the can.candidate table, or bubble-up from subordinate changes to any of the candidate’s nested records (attachments, contacts, education, experiences, certifications, projects, skill proficiencies, social media links, calendars, preferred locations).

Payload Example

{
  "id": 101,
  "first_name": "Jane",
  "middle_name": "Marie",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone_number": "+19876543210",
  "country": "USA",
  "user_id": 123,
  "external_id": "ext_can_101",
  "old_id": null,
  "resume_file_id": 2001,
  "profile_pic_file_id": null,
  "cf": {},
  "meta": {},
  "is_active": true,
  "is_tnc_accepted": true,
  "is_recording_consent_accepted": null,
  "thread_id": null,
  "notice_period": null,
  "work_authorization": null,
  "expected_salary": null,
  "total_years_experience": null,
  "avg_tenure_months": null,
  "created_at": "2023-11-01T10:00:00Z",
  "created_by": 1,
  "updated_at": "2023-11-02T14:00:00Z",
  "updated_by": 1,
  "attachments": [],
  "contacts": [],
  "calendars": [],
  "education": [
    {
      "id": 1,
      "title": "B.Sc. Computer Science",
      "type": null,
      "field_of_study": "Computer Science",
      "awarding_board": null,
      "institute": "MIT",
      "grade": null,
      "gpa_value": null,
      "started_at": null,
      "completed_at": "2020-05-15",
      "is_current": false,
      "external_id": null,
      "created_at": "2023-11-01T10:00:00Z",
      "created_by": 1,
      "updated_at": "2023-11-02T14:00:00Z",
      "updated_by": 1
    }
  ],
  "experiences": [
    {
      "id": 1,
      "type": null,
      "organization": "Acme Corp",
      "location": null,
      "designation": "Software Engineer",
      "description": null,
      "started_at": null,
      "completed_at": null,
      "is_current": true,
      "responsibilities": [],
      "tools_used": [],
      "external_id": null,
      "created_at": "2023-11-01T10:00:00Z",
      "created_by": 1,
      "updated_at": "2023-11-02T14:00:00Z",
      "updated_by": 1
    }
  ],
  "certifications": [],
  "preferred_locations": [],
  "projects": [],
  "skill_proficiencies": [],
  "social_media_links": []
}

Payload Type Showcase

{
  id: number;
  first_name: string | null;
  middle_name: string | null;
  last_name: string | null;
  email: string;
  phone_number: string | null;
  country: string | null;
  user_id: number;
  external_id: string | null;
  old_id: number | null;
  resume_file_id: number | null;
  profile_pic_file_id: number | null;
  cf: Record<string, any>;
  meta: Record<string, any>;
  is_active: boolean;
  is_tnc_accepted: boolean;
  is_recording_consent_accepted: boolean | null;
  thread_id: number | null;
  notice_period: string | null;
  work_authorization: string | null;
  expected_salary: string | null;
  total_years_experience: number | null;
  avg_tenure_months: number | null;
  created_at: string;
  created_by: number;
  updated_at: string;
  updated_by: number;
  attachments: {
    id: number;
    file_id: number;
    file_type_id: number;
    education_id: number | null;
    experience_id: number | null;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  contacts: {
    id: number;
    phone_number: string | null;
    address: string | null;
    city: string | null;
    state: string | null;
    country: string | null;
    zipcode: string | null;
    is_current: boolean;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  calendars: {
    id: number;
    from: string;
    to: string;
    availability_status: string;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  education: {
    id: number;
    title: string | null;
    type: string | null;
    field_of_study: string | null;
    awarding_board: string | null;
    institute: string | null;
    grade: string | null;
    gpa_value: number | null;
    started_at: string | null;
    completed_at: string | null;
    is_current: boolean;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  experiences: {
    id: number;
    type: string | null;
    organization: string | null;
    location: string | null;
    designation: string | null;
    description: string | null;
    started_at: string | null;
    completed_at: string | null;
    is_current: boolean;
    responsibilities: any[];
    tools_used: any[];
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  certifications: {
    id: number;
    name: string;
    issuer: string | null;
    issue_date: string | null;
    expiry_date: string | null;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  preferred_locations: {
    id: number;
    location: Record<string, any>;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  projects: {
    id: number;
    title: string;
    description: string | null;
    start_date: string | null;
    end_date: string | null;
    external_id: string | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
    technologies: {
      id: number;
      technology: string;
      created_at: string;
      created_by: number;
      updated_at: string;
      updated_by: number;
    }[];
  }[];
  skill_proficiencies: {
    id: number;
    skill_id: number;
    proficiency: string | null;
    proficiency_label: string | null;
    last_used: string | null;
    evidence_snippet: Record<string, any> | null;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
  social_media_links: {
    id: number;
    social_media: string;
    link: string;
    created_at: string;
    created_by: number;
    updated_at: string;
    updated_by: number;
  }[];
}

Field Notes

cf (custom fields) and meta are JSONB — shape varies per tenant configuration.
responsibilities and tools_used on experiences are JSONB arrays.
evidence_snippet on skill proficiencies is JSONB containing parsed resume excerpts.
location on preferred_locations is JSONB with structured geo data.
projects nests technologies as a second-level subordinate.
file_type_id on attachments references a lookup enum to distinguish resumes, certificates, etc.
All subordinate arrays are pre-filtered to exclude soft-deleted records.

​Description

​Integration Details

​Trigger

​Payload Example

​Payload Type Showcase

​Field Notes

Description

Integration Details

Trigger

Payload Example

Payload Type Showcase

Field Notes