# Add a new contact to automation

This endpoint adds a new lead to a particular automation. A lead is created with the given list UUID and attached to the automation. If  is provided only new contacts will be added to automation, otherwise the request returns a reason "skipped."


Endpoint: POST /flows/api/flows/{flowUuid}/add-new-lead
Version: 3.0
Security: bearerAuth

## Path parameters:

  - `flowUuid` (string, required)
    The UUID of the automation to which the contact should be added.

## 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_lead_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.

  - `flow_segment_id` (integer)
    The ID of a specific automation segment. Defaults to 1 if not provided.
    Example: 1

  - `skip_if_lead_exists` (boolean)
    If true and the contact already exists, it won't be added to automation.
    Example: true

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Invalid input."

## Response 422 fields (application/json):

  - `message` (string)
    Example: "Validation failed."

  - `errors` (object)