Work Milestone

Events or milestones related to an individual's work history.

The Work Milestone insight provides information about significant events or milestones related to an individual's work history, such as recent job changes, upcoming work anniversaries, and work anniversaries. This insight can be retrieved using the contact's email address or LinkedIn URL.

🚧

Note: the only current available parameters for generate-insights are contactEmail and contactLinkedinUrl.

• The system will pass back an array of insights, ranked by relevance.
• The below documentation still accurately covers our schema, and demonstrates what might exist in that array.
• Soon, you'll be able to specify certain insight types in your API request. Coming Q3 2024.

Retrieving Work Milestone Insight

To retrieve the Work Milestone insight using the Autobound Insights API, you need to make a POST request to the /generate-insights endpoint with the appropriate parameters.

Python

import requests

url = 'https://api.autobound.ai/api/external/generate-insights/v1.0.0'
headers = {
    'X-API-KEY': 'YOUR-API-KEY-HERE',
    'Content-Type': 'application/json'
}
data = {
    "contactEmail": "[email protected]",
    "insightType": "WORK_MILESTONE"
}

response = requests.post(url, headers=headers, json=data)
print(response.text)

Response Format

The API will respond with the Work Milestone insight in JSON format. The response will contain an object with the following fields:

json

{
  "data": [
    {
      "subtype": "Recent job change",
      "contactName": "Daniel",
      "yearStarted": 2019,
      "monthStarted": 3,
      "previousEmployer": "Oracle",
      "currentEmployer": "Autobound"
    },
    {
      "subtype": "Upcoming work anniversary",
      "contactName": "Daniel",
      "yearStarted": 2019,
      "monthStarted": 3,
      "anniversaryYear": 5,
      "currentEmployer": "Autobound"
    },
    {
      "subtype": "Work anniversary",
      "contactName": "Daniel",
      "yearStarted": 2019,
      "monthStarted": 3,
      "anniversaryYear": 5,
      "currentEmployer": "Autobound"
    }
  ]
}

Field Descriptions

• subtype (string): The subtype of the work milestone. Possible values are "Recent job change", "Upcoming work anniversary", and "Work anniversary".
• contactName (string): The name of the contact associated with the work milestone.
• yearStarted (integer): The year the contact started their current job or the job associated with the milestone.
• monthStarted (integer): The month the contact started their current job or the job associated with the milestone.
• anniversaryYear (integer, optional): The year of the work anniversary. Only applicable for "Upcoming work anniversary" and "Work anniversary" subtypes.
• previousEmployer (string, optional): The name of the contact's previous employer. Only applicable for the "Recent job change" subtype.
• currentEmployer (string): The name of the contact's current employer.

Use Cases

The Work Milestone insight is valuable for various use cases, such as:

• Personalized Outreach: Tailor your outreach messages based on the contact's work milestones. For example, congratulate them on a recent job change or upcoming work anniversary to build rapport and show that you have done your research.
• Sales Timing: Identify opportunities to reach out to contacts at key moments in their career, such as when they have recently changed jobs or are approaching a significant work anniversary. These milestones can indicate a good time to initiate a conversation or propose a solution.
• Account Mapping: Use work milestone insights to map out the key contacts within an account and understand their tenure and job history. This information can help you identify decision-makers, influencers, and potential champions within the organization.
• Relationship Building: Leverage work milestones to find common ground and build stronger relationships with your contacts. For example, if you have worked at the same company as the contact in the past, you can use that shared experience to establish a connection.
• Lead Qualification: Assess the potential of a lead based on their work milestones. A recent job change or a significant work anniversary may indicate a higher likelihood of the contact being open to new opportunities or solutions.
• Retention and Upselling: Monitor work milestones of existing customers to identify opportunities for retention and upselling. A work anniversary or job change may signal a good time to check in, discuss their current needs, and propose additional products or services.

By leveraging the Work Milestone insight, you can gain valuable information about your contacts' career events and use that information to personalize your outreach, build stronger relationships, and identify opportunities for sales and account management.