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

> Add leads to an existing Amplemarket lead list. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Add leads to an existing Amplemarket lead list.

> [!NOTE]
>
> Tool ID: `amplemarket_post_lead_lists_id_leads`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'amplemarket_post_lead_lists_id_leads',
  {
    "id": "id_123",
    "leads": [
      {
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "email": "jane.doe@example.com",
        "title": "VP of Engineering"
      }
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute amplemarket_post_lead_lists_id_leads --input '{
  "id": "id_123",
  "leads": [
    {
      "linkedin_url": "https://www.linkedin.com/in/jane-doe",
      "email": "jane.doe@example.com",
      "title": "VP of Engineering"
    }
  ]
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "total": 123,
    "total_added_to_lead_list": 123
  }
}
```

Use `deepline describe amplemarket_post_lead_lists_id_leads --json` for the latest machine-readable contract.

## Input reference

Add Leads to a List

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Lead List id |
| `payload.type` | `"linkedin" \| "email" \| "titles_and_company"` | No | — | Allowed: `linkedin`, `email`, `titles_and_company`. |
| `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. Maximum items: 10000. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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 reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.total` | `integer` | No | — | Total number of leads processed in the request. |
| `result.data.total_added_to_lead_list` | `integer` | No | — | Total number of leads successfully added to the lead list. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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>

## Deepline cost

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

## Related documentation

* [Amplemarket provider guide](https://deepline.com/docs/providers/amplemarket/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.