> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplemarket Post Lead Lists Id Leads: Inputs, Cost & CLI

> Add Leads to a List. Amplemarket Amplemarket Post Lead Lists Id Leads docs include request fields, response shape, pricing notes, and Deepline CLI examples.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=amplemarket_post_lead_lists_id_leads:{"id":"{{id}}","leads":"{{leads}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name            | Type                                            | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------- | ----------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.id`    | `string`                                        | Yes      |         | Lead List id                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `payload.type`  | `"linkedin" \| "email" \| "titles_and_company"` | No       |         |                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `payload.leads` | `array`                                         | Yes      |         | You can add up to 10,000 leads at a time. However, each Lead List can have a maximum of 60,000 leads. When approaching this limit, new leads will be added partially until the limit is reached. When the limit is hit, a 409 HTTP status code will be returned. Enriching, email validation, and reveal settings are inherited from the Lead List settings. If credits are spent, those will be deducted from the admin user of the account. |

### Allowed values

| Field          | Allowed values                            |
| -------------- | ----------------------------------------- |
| `payload.type` | `linkedin`, `email`, `titles_and_company` |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Add Leads to a List",
    "properties": {
      "id": {
        "type": "string",
        "description": "Lead List id"
      },
      "type": {
        "type": "string",
        "enum": [
          "linkedin",
          "email",
          "titles_and_company"
        ]
      },
      "leads": {
        "type": "array",
        "description": "You can add up to 10,000 leads at a time. However, each Lead List can have a maximum of 60,000 leads. When approaching this limit, new leads will be added partially until the limit is reached. When the limit is hit, a 409 HTTP status code will be returned. Enriching, email validation, and reveal settings are inherited from the Lead List settings. If credits are spent, those will be deducted from the admin user of the account.",
        "maxItems": 10000,
        "items": {
          "type": "object",
          "properties": {
            "linkedin_url": {
              "type": "string"
            },
            "email": {
              "type": "string",
              "format": "email"
            },
            "title": {
              "type": "string"
            },
            "company_name": {
              "type": "string"
            },
            "company_domain": {
              "type": "string"
            },
            "phone_numbers": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "context": {
              "type": "object",
              "description": "Additional custom fields to store on the lead. These fields are flattened into the lead data fields.",
              "additionalProperties": true
            }
          },
          "additionalProperties": true
        }
      }
    },
    "required": [
      "id",
      "leads"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "total": {
            "type": "integer",
            "description": "Total number of leads processed in the request."
          },
          "total_added_to_lead_list": {
            "type": "integer",
            "description": "Total number of leads successfully added to the lead list."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute amplemarket_post_lead_lists_id_leads --payload '{
  "id": "string",
  "leads": "array"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.