---
updatedAt: 2025-07-01T09:50:56.000Z
---

Fetch the complete documentation index at: https://workable.readme.io/llms.txt. Use this file to discover all available pages before exploring further.

# Candidate Events

The data that Workable pushes when an event gets triggered is similar to [candidate details](https://workable.readme.io/reference/job-candidates-show) endpoint.

| key                                    | type        | description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| :------------------------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| data                                   | `object`    | Data wrapper                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data.account                           | `object`    | Account wrapper                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data.account.name                      | `string`    | The name of the account                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| data.account.subdomain                 | `string`    | The subdomain of the account                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data.address                           | `string`    | The address of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data.cover\_letter                     | `string`    | The cover letter provided when candidate applied                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data.created\_at                       | `timestamp` | The timestamp the candidate  created                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| data.disqualified                      | `boolean`   | Indicates if the candidate is disqualified                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| data.withdrew                          | `boolean`   | Indicates if the candidate withdrew and disqualified                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| data.disqualification\_reason          | `string`    | The reason the candidate was disqualified                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| data.disqualified\_at                  | `timestamp` | The timestamp the candidate  was disqualified                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| data.domain                            | `string`    | The domain of the referrer site that linked to the job page or the job board the job advertised                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data.education\_entries                | `array`     | A collection with education entries                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data.education\_entry.id               | `string`    | Education entry identifier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| data.education\_entry.degree           | `string`    | The graduation degree                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| data.education\_entry.school           | `string`    | The name of the school graduated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data.education\_entry.field\_of\_study | `string`    | The field of study                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| data.education\_entry.start\_date      | `date`      | The date started                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data.education\_entry.end\_date        | `date`      | The date ended                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data.email                             | `string`    | The email address of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| data.experience\_entries               | `array`     | A collection with working experience entries                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data.experience\_entry.title           | `string`    | The title of the experience entry                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| data.experience\_entry.company         | `string`    | The company name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data.experience\_entry.summary         | `string`    | The summary of the experience entry                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data.experience\_entry.industry        | `string`    | The industry of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| data.experience\_entry.start\_date     | `date`      | The date started                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| data.experience\_entry.end\_date       | `date`      | The date ended                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data.experience\_entry.current         | `boolean`   | Indicates if currently works there                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| data.firstname                         | `string`    | The first name of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data.headline                          | `string`    | The headline of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| data.id                                | `string`    | The candidate identifier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data.image\_url                        | `url`       | Url of candidate's avatar. Available only if provided by the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| data.job                               | `object`    | Job wrapper                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| data.job.shortcode                     | `string`    | The shortcode of the job                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data.job.title                         | `string`    | The title of the job                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| data.lastname                          | `string`    | The last name of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data.name                              | `string`    | The full name of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data.outbound\_mailbox                 | `string`    | Mailbox that can be used to communicate with the candidate and inform the recruitment team of the job as well                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| data.phone                             | `string`    | The phone number of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| data.profile\_url                      | `url`       | Url to the candidate's profile                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| data.resume\_url                       | `url`       | Url to the candidate resume                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| data.skills                            | `array`     | A collection with skill names                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| data.social\_profiles                  | `array`     | A collection with social profiles of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| data.social\_profile.type              | `string`    | The slug name of the social profile. It can be one of the following types: `academiaedu`, `angellist`, `behance`, `bitbucket`, `blogger`, `crunchbase`, `dandyid`, `delicious`, `deviantart`, `digg`, `doyoubuzz`, `dribble`, `dribbble`, `econsultancy`, `facebook`, `flavorsme`, `flickr`, `fullcontact`, `getglue`, `gist`, `github`, `goodreads`, `googleplus`, `gravatar`, `hackernews`, `hiim`, `klout`, `lanyrd`, `linkedin`, `myspace`, `ohloh`, `orkut`, `pinterest`, `quora`, `reddit`, `scribd`, `skype`, `slideshare`, `stackexchange`, `stackoverflow`, `tumblr`, `twitter`, `typepad`, `vk`, `wordpress`, `xing` |
| data.social\_profile.name              | `string`    | The full name of the social profile                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data.social\_profile.url               | `url`       | Url to the candidate's social profile page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| data.sourced                           | `boolean`   | Indicates if the candidate is sourced `true` or applied `false`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data.stage                             | `string`    | The name of the current stage. See [stages endpoint](https://workable.readme.io/reference/stages#/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data.summary                           | `string`    | The summary of the candidate                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data.tags                              | `array`     | A collection with tags                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| data.updated\_at                       | `timestamp` | The timestamp the candidate  last updated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| data.uploader\_id                      | `string`    | The id of the member uploaded the candidate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| event\_type                            | `string`    | The type of the event                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| fired\_at                              | `timestamp` | The date the event was triggered                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| id                                     | `id`        | The event identifier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| resource\_type                         | `string`    | The type of the payload resource                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

## Example Payload

```
{
  "data": {
    "account": {
      "name": "Groove Tech",
      "subdomain": "groove-tech"
    },
    "address": "25772 Gustave Shore, Iowa, USA",
    "cover_letter": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
    "created_at": "2015-07-09T10:55:53Z",
    "disqualification_reason": null,
    "disqualified": false,
    "disqualified_at": null,
    "domain": null,
    "education_entries": [
      {
        "degree": "MBA",
        "end_date": "2011-03-30",
        "field_of_study": null,
        "school": "University of Pennsylvania",
        "start_date": "2008-03-01"
      },
      {
        "degree": "B.S.",
        "end_date": "2007-03-30",
        "field_of_study": "Marketing Communication & Economics",
        "school": "University of Chicago",
        "start_date": "2004-09-01"
      }
    ],
    "email": "jj_botha@fakemail.com",
    "experience_entries": [
      {
        "company": "Vox Mobile",
        "current": false,
        "end_date": "2014-03-30",
        "industry": "Telecommunications",
        "start_date": "2011-03-01",
        "summary": null,
        "title": "Sales Director"
      }
    ],
    "firstname": null,
    "headline": "Professional Administration Manager",
    "id": "3fc9a80f",
    "image_url": null,
    "job": {
      "shortcode": "GROOV005",
      "title": "Office Manager"
    },
    "lastname": null,
    "name": "Jj Botha",
    "outbound_mailbox": "b-6adwdc@outbound.dev-workable.mailgun.org",
    "phone": "1-859-557-6573",
    "profile_url": "https://groove-tech.workable.com/backend/jobs/376844767/candidates/1070179133",
    "resume_url": null,
    "skills": [
      {
        "name": "travel planning"
      },
      {
        "name": "problem solving"
      }
    ],
    "social_profiles": [
      {
        "type": "twitter",
        "url": "http://www.twitter.com/jj_botha",
        "username": "jj_botha"
      },
      {
        "type": "linkedin",
        "url": "http://www.linkedin.com/in/jj_botha"
      },
      {
        "type": "googleplus",
        "url": "https://plus.google.com/6908286706342698"
      }
    ],
    "sourced": true,
    "stage": "Hired",
    "summary": "A focused, results-driven team player with many year experience in the field. Working my way up to management level, I have experience in every aspect of this role. I understand the challenges it brings, and have a proven track record of providing solutions.",
    "tags": [],
    "updated_at": "2015-07-09T10:55:53Z",
    "uploader_id": null
  },
  "event_type": "candidate_moved",
  "fired_at": "2017-03-27T09:32:45Z",
  "id": "1b1c8399",
  "resource_type": "candidate"
}
```