---
title: "POST /org-storage/leads/save"
method: POST
path: "/org-storage/leads/save"
tags: ["org-storage"]
---

# POST /org-storage/leads/save

`POST /org-storage/leads/save`

Save one lead - Beta.

## Headers

- `X-Phantombuster-Org` string

## Request body

- object
  - `linkedinProfileUrl` string, required — linkedin profile url
  - `linkedinCompanyUrl` string — linkedin company url (deprecated, use linkedinCompanySlug instead)
  - `linkedinCompanySlug` string — linkedin company slug
  - `twitterProfileUrl` string — twitter profile url
  - `linkedinPreviousCompanyUrl` string — linkedin previous company url
  - `metadata` object — metadata from the agent script
    - `data` object, required — metadata from the agent script
  - `linkedinSchoolCompanyUrl` string — linkedin school company url
  - `linkedinPreviousSchoolCompanyUrl` string — linkedin previous school company url
  - `salesNavigatorProfileUrl` string — sales navigator profile url
  - `firstName` string — lead firstName
  - `lastName` string — lead lastName
  - `location` string — lead location
  - `civility` string — lead civility
  - `linkedinOpenProfile` boolean — lead linkedin profile is open
  - `linkedinIsHiringBadge` boolean — lead linkedin is hiring badge
  - `linkedinIsOpenToWorkBadge` boolean — lead linkedin is open to work badge
  - `professionalEmails` string[] — lead professional emails
  - `personalEmails` string[] — lead personal emails
  - `phoneNumbers` string[] — lead phone numbers
  - `websites` string[] — lead websites
  - `companyName` string — lead company
  - `companyWebsite` string — lead company website
  - `linkedinCompanyId` string — linkedin company id
  - `linkedinProfileId` string — lead linkedin profile id
  - `linkedinProfileUrn` string — lead linkedin profile urn
  - `linkedinProfileImageUrn` string — lead linkedin profile picture image urn
  - `linkedinProfileImageUrl` string — lead linkedin profile picture image url
  - `linkedinHeadline` string — lead linkedin profile headline
  - `linkedinJobTitle` string — lead linkedin job title
  - `linkedinJobDateRange` string — lead linkedin job date range
  - `linkedinJobLocation` string — lead linkedin job location
  - `companyIndustry` string — industry of the lead's company
  - `linkedinFollowersCount` number — lead linkedin followers count
  - `linkedinDescription` string — lead linkedin description
  - `linkedinJobDescription` string — lead linkedin job description
  - `linkedinPreviousJobDescription` string — lead linkedin previous job description
  - `linkedinSkillsLabel` string — lead linkedin skills label
  - `previousCompanyName` string — lead previous company name
  - `linkedinPreviousJobTitle` string — lead previous job title
  - `linkedinPreviousJobDateRange` string — lead previous job date range
  - `linkedinPreviousJobLocation` string — lead previous job location
  - `linkedinSchoolName` string — lead linkedin school name
  - `linkedinPreviousSchoolName` string — lead linkedin previous school name
  - `linkedinSchoolDegree` string — lead linkedin school degree
  - `linkedinPreviousSchoolDegree` string — lead linkedin previous school degree
  - `linkedinSchoolDateRange` string — lead linkedin school date range
  - `linkedinPreviousSchoolDateRange` string — lead linkedin previous school date range
  - `linkedinSchoolDescription` string — lead linkedin school description
  - `linkedinPreviousSchoolDescription` string — lead linkedin previous school description
  - `linkedinAccountRelativeProperties` object[] — Collection of Lead LinkedIn properties grouped by scraping LinkedIn user
    - `sourceUserId` string, required — Source LinkedIn profile id (user who scraped)
    - `connectionDegree` integer — Lead LinkedIn connection degree
  - `crmAccountRelativeProperties` object[] — Collection of CRM related properties grouped by CRM name (contains only one item per CRM)
    - `crmContactId` string, required
    - `crmAccountId` string, required
    - `crmName` 'hubspot' | 'pipedrive' | 'salesforce', required
  - `audienceOfLeads` string[] — list of lead ids this lead is an audience of
  - `aiGeneratedProperties` object — AI generated properties
  - `customResultsFileName` string — Custom Results File Name
  - `error` string — error property from the agent script

## Response `200`

Lead successfully updated or created.

- object
  - `isCreation` boolean — Indicates if the lead is created or inserted
  - `id` string, required
  - `linkedinProfileSlug` string, required
  - `linkedinCompanySlug` string
  - `twitterProfileHandle` string
  - `linkedinPreviousCompanySlug` string
  - `linkedinSchoolCompanySlug` string
  - `linkedinPreviousSchoolCompanySlug` string
  - `salesNavigatorProfileId` string
  - `salesNavigatorCompanyId` string
  - `firstName` string — lead firstName
  - `lastName` string — lead lastName
  - `location` string — lead location
  - `civility` string — lead civility
  - `linkedinOpenProfile` boolean — lead linkedin profile is open
  - `linkedinIsHiringBadge` boolean — lead linkedin is hiring badge
  - `linkedinIsOpenToWorkBadge` boolean — lead linkedin is open to work badge
  - `professionalEmails` string[] — lead professional emails
  - `personalEmails` string[] — lead personal emails
  - `phoneNumbers` string[] — lead phone numbers
  - `websites` string[] — lead websites
  - `companyName` string — lead company
  - `companyWebsite` string — lead company website
  - `linkedinCompanyId` string — linkedin company id
  - `linkedinProfileId` string — lead linkedin profile id
  - `linkedinProfileUrn` string — lead linkedin profile urn
  - `linkedinProfileImageUrn` string — lead linkedin profile picture image urn
  - `linkedinProfileImageUrl` string — lead linkedin profile picture image url
  - `linkedinHeadline` string — lead linkedin profile headline
  - `linkedinJobTitle` string — lead linkedin job title
  - `linkedinJobDateRange` string — lead linkedin job date range
  - `linkedinJobLocation` string — lead linkedin job location
  - `companyIndustry` string — industry of the lead's company
  - `linkedinFollowersCount` number — lead linkedin followers count
  - `linkedinDescription` string — lead linkedin description
  - `linkedinJobDescription` string — lead linkedin job description
  - `linkedinPreviousJobDescription` string — lead linkedin previous job description
  - `linkedinSkillsLabel` string — lead linkedin skills label
  - `previousCompanyName` string — lead previous company name
  - `linkedinPreviousJobTitle` string — lead previous job title
  - `linkedinPreviousJobDateRange` string — lead previous job date range
  - `linkedinPreviousJobLocation` string — lead previous job location
  - `linkedinSchoolName` string — lead linkedin school name
  - `linkedinPreviousSchoolName` string — lead linkedin previous school name
  - `linkedinSchoolDegree` string — lead linkedin school degree
  - `linkedinPreviousSchoolDegree` string — lead linkedin previous school degree
  - `linkedinSchoolDateRange` string — lead linkedin school date range
  - `linkedinPreviousSchoolDateRange` string — lead linkedin previous school date range
  - `linkedinSchoolDescription` string — lead linkedin school description
  - `linkedinPreviousSchoolDescription` string — lead linkedin previous school description
  - `linkedinAccountRelativeProperties` object[] — Collection of Lead LinkedIn properties grouped by scraping LinkedIn user
    - `sourceUserId` string, required — Source LinkedIn profile id (user who scraped)
    - `connectionDegree` integer — Lead LinkedIn connection degree
  - `crmAccountRelativeProperties` object[] — Collection of CRM related properties grouped by CRM name (contains only one item per CRM)
    - `crmContactId` string, required
    - `crmAccountId` string, required
    - `crmName` 'hubspot' | 'pipedrive' | 'salesforce', required
  - `audienceOfLeads` string[] — list of lead ids this lead is an audience of
  - `editionsHistory` union[], required
    - union
      - object
        - `type` 'agent', required
        - `timestamp` number, required
        - `mainAgentId` string, required
        - `workerAgentId` string
        - `resultFile` string
        - `errorMessage` string
        - `identityProfileId` string — Source profile id (user who scraped)
        - `identityType` 'linkedin'
      - object
        - `type` 'manual', required
        - `timestamp` number, required
        - `userId` string
        - `editedProperties` string[], required
      - object
        - `type` 'browser_extension', required
        - `timestamp` number, required
        - `extensionType` 'chrome' | 'firefox' | 'edge', required
  - `metadata` object — metadata for the lead
  - `aiGeneratedProperties` object — AI generated properties
  - `company` object
    - `id` string, required
    - `companyId` string, required
    - `companySlug` string, required
    - `properties` object, required
    - `createdAt` number, required
    - `updatedAt` number, required

---

[API](https://skmtc.net/phantombuster/apis/phantombuster-api-v2.md) · [All operations](https://skmtc.net/phantombuster/apis/phantombuster-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phantombuster/phantombuster-api-v2/revisions/acf0049d7c7f/schema)