# Create or Update a contact

Creates or updates a contact in the specified list. If the contact exists and  is true, it will be updated. Optionally, the contact can also be moved to the specified list.

Endpoint: POST /leads/api/leads/upsert
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `lead` (object, required)
    The contact data to be created and attached to the automation.

  - `lead.linkedin_id` (string, required)
    The contact's LinkedIn ID or profile handle.
    Example: "john-doe-123456 or ACoAAAB6GuQBOXo75numqJfM9u08uHgjOSo4p9U"

  - `lead.first_name` (string)
    The contact's first name.
    Example: "John"

  - `lead.last_name` (string)
    The contact's last name.
    Example: "Doe"

  - `lead.company_name` (string)
    The name of the company the contact is associated with.
    Example: "ExampleCorp"

  - `lead.ln_id` (string,null)
    Example: "ACoAAAB6GuQBOXo75numqJfM9u08uHgjOSo4p9U"

  - `lead.sn_id` (string,null)
    Example: "ACwAAAB6GuQBEz2TMHbG4sa7Nw5wSi7cJXMQkPI"

  - `lead.linkedin` (string,null)
    Example: "christina-sletner-b4481a2"

  - `lead.email` (string)
    A contactable email address for the contact.
    Example: "john.doe@example.com"

  - `lead.about` (string)
    Description of contact
    Example: "john.doe@example.com"

  - `lead.domain` (string)
    Contact's company domain to find his email
    Example: "somecoolcompany.com"

  - `lead.headline` (string,null)
    Example: "Sales & Partner Manager I ERP-/Dynamics 365 Finance/OnSite 365 at Advania Norge"

  - `lead.position` (string,null)
    Example: "Sales & Partner Manager"

  - `lead.raw_address` (string,null)
    Example: "Oslo, Oslo, Norway"

  - `custom_fields` (object)
    Custom fields and their values.
    Example: {"field_position":"CTO","field_experience":"10 years"}

  - `list_uuid` (string, required)
    UUID of the target list.
    Example: "uuid-uuid-uuid-uuid"

  - `update_if_exists` (boolean)
    If true (default), updates contact if it already exists.
    Example: true

  - `move_to_list` (boolean)
    If true, moves the existing contact to the specified list.

## Response 200 fields (application/json):

  - `uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `team_id` (integer)
    Example: 1

  - `user_id` (integer,null)
    Example: 1

  - `sender_profile_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `list_uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `data_source_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `pipeline_stage_uuid` (string)
    Example: "uuid-uuid-uuid-uuid-example"

  - `company_uuid` (string,null)
    Example: "uuid-uuid-uuid-uuid-example"

  - `name` (string,null)
    Example: "Christina Sletner"

  - `first_name` (string,null)
    Example: "Christina"

  - `last_name` (string,null)
    Example: "Sletner"

  - `company_name` (string,null)
    Example: "Advania Norge"

  - `company_ln_id` (string,null)
    Example: "98"

  - `position` (string,null)
    Example: "Sales & Partner Manager"

  - `headline` (string,null)
    Example: "Sales & Partner Manager I ERP-/Dynamics 365 Finance/OnSite 365 at Advania Norge"

  - `about` (string,null)
    Example: "Busy times with contributing to our customers' cloud journey..."

  - `avatar_url` (string,null)
    Example: "https://example.com/avatar.jpg"

  - `ln_id` (string,null)
    Example: "ACoAAAB6GuQBOXo75numqJfM9u08uHgjOSo4p9U"

  - `sn_id` (string,null)
    Example: "ACwAAAB6GuQBEz2TMHbG4sa7Nw5wSi7cJXMQkPI"

  - `linkedin` (string,null)
    Example: "christina-sletner-b4481a2"

  - `facebook` (string,null)
    Example: "christina-sletner"

  - `twitter` (string,null)
    Example: "christina-sletner"

  - `work_email` (string,null)
    Example: "christina.sletner@advania.no"

  - `personal_email` (string,null)
    Example: "christina88@yahoo.com"

  - `work_phone_number` (string,null)
    Example: "+123456789"

  - `personal_phone_number` (string,null)
    Example: "+123456789"

  - `connections_number` (integer,null)
    Example: 500

  - `followers_number` (integer,null)
    Example: 1000

  - `primary_language` (string,null)
    Example: "en"

  - `supported_languages` (array,null)
    Example: ["en","no"]

  - `has_open_profile` (integer,null)
    Example: 1

  - `has_verified_profile` (integer,null)
    Example: 1

  - `has_premium` (integer,null)
    Example: 1

  - `experience` (array,null)

  - `experience.title` (string)
    Example: "Sales Manager"

  - `experience.company` (string)
    Example: "Advania Norge"

  - `experience.start_date` (string)
    Example: "2018-01-01"

  - `experience.end_date` (string)
    Example: "2022-12-31"

  - `posts` (array,null)

  - `posts.content` (string)
    Example: "Just attended a great conference on cloud computing!"

  - `posts.date` (string)
    Example: "2022-05-15T09:30:00Z"

  - `educations` (array,null)

  - `educations.school` (string)
    Example: "University of Oslo"

  - `educations.degree` (string)
    Example: "MBA"

  - `educations.field_of_study` (string)
    Example: "Business Administration"

  - `educations.start_year` (string)
    Example: "2012"

  - `educations.end_year` (string)
    Example: "2014"

  - `skills` (array,null)
    Example: ["Project Management","Sales","ERP Systems"]

  - `top_voices` (array,null)
    Example: ["Thought Leader 1","Influencer 2"]

  - `raw_address` (string,null)
    Example: "Oslo, Oslo, Norway"

  - `location` (array,null)

  - `location.address_string` (string)
    Example: "Oslo, Oslo, Norway"

  - `tags` (array,null)
    Example: ["uuid-uuid-uuid-uuid-example","uuid-uuid-uuid-uuid-example"]

  - `status` (string)
    Example: "ok"

  - `linkedin_status` (string)
    Example: "active"

  - `email_status` (string,null)
    Example: "verified"

  - `unread_counts` (array)

  - `unread_counts.category` (string)
    Example: "messages"

  - `unread_counts.count` (integer)
    Example: 5

  - `last_automation_approve_at` (string,null)
    Example: "2023-07-21T10:15:30Z"

  - `created_at` (string,null)
    Example: "2022-12-11T10:00:00Z"

  - `updated_at` (string,null)
    Example: "2022-12-11T11:00:00Z"