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

# Instantly: Move Leads

> Moving Instantly leads between campaigns or lead lists. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Moving Instantly leads between campaigns or lead lists.

> [!NOTE]
>
> Tool ID: `instantly_move_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(
  'instantly_move_leads',
  {
    "search": "software companies hiring engineers",
    "filter": "example",
    "campaign": "example"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute instantly_move_leads --input '{
  "search": "software companies hiring engineers",
  "filter": "example",
  "campaign": "example"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe instantly_move_leads --json` for the complete live contract.

## Input reference

Move Instantly leads to a different campaign or lead list.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.search` | `string` | No | — | Minimum length: 1. |
| `payload.filter` | `string` | No | — | Minimum length: 1. |
| `payload.campaign` | `string` | No | — | Minimum length: 1. |
| `payload.list_id` | `string` | No | — | Minimum length: 1. |
| `payload.in_campaign` | `boolean` | No | — | — |
| `payload.in_list` | `boolean` | No | — | — |
| `payload.ids` | `array` | No | — | Minimum items: 1. |
| `payload.queries` | `array` | No | — | Minimum items: 1. |
| `payload.excluded_ids` | `array` | No | — | Minimum items: 1. |
| `payload.contacts` | `array` | No | — | Minimum items: 1. |
| `payload.to_campaign_id` | `string` | No | — | Minimum length: 1. |
| `payload.to_list_id` | `string` | No | — | Minimum length: 1. |
| `payload.ignore_resource_filter_clauses` | `boolean` | No | — | — |
| `payload.check_duplicates_in_campaigns` | `boolean` | No | — | — |
| `payload.skip_leads_in_verification` | `boolean` | No | — | — |
| `payload.limit` | `integer` | No | — | Minimum: 1. |
| `payload.assigned_to` | `string` | No | — | Minimum length: 1. |
| `payload.esp_code` | `integer` | No | — | — |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Move Instantly leads to a different campaign or lead list.",
    "properties": {
      "search": {
        "type": "string",
        "minLength": 1
      },
      "filter": {
        "type": "string",
        "minLength": 1
      },
      "campaign": {
        "type": "string",
        "minLength": 1
      },
      "list_id": {
        "type": "string",
        "minLength": 1
      },
      "in_campaign": {
        "type": "boolean"
      },
      "in_list": {
        "type": "boolean"
      },
      "ids": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "queries": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "object",
          "properties": {
            "actionType": {
              "type": "string",
              "enum": [
                "reply",
                "email-open",
                "last-contacted",
                "link-click",
                "lead-status",
                "lead-status-change"
              ]
            },
            "values": {
              "type": "object",
              "minProperties": 1,
              "properties": {
                "occurrence-days": {
                  "type": "number",
                  "minimum": 0
                },
                "occurrence-count": {
                  "type": "object",
                  "properties": {
                    "condition": {
                      "type": "string",
                      "enum": [
                        "more",
                        "less",
                        "equal"
                      ]
                    },
                    "count": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "required": [
                    "condition",
                    "count"
                  ],
                  "additionalProperties": false
                },
                "lead-status": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "number"
                    },
                    "condition": {
                      "type": "string",
                      "enum": [
                        "is",
                        "is-not"
                      ]
                    }
                  },
                  "required": [
                    "status",
                    "condition"
                  ],
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            }
          },
          "required": [
            "actionType",
            "values"
          ],
          "additionalProperties": false
        }
      },
      "excluded_ids": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "contacts": {
        "type": "array",
        "minItems": 1,
        "items": {
          "type": "string",
          "minLength": 1,
          "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
        }
      },
      "to_campaign_id": {
        "type": "string",
        "minLength": 1
      },
      "to_list_id": {
        "type": "string",
        "minLength": 1
      },
      "ignore_resource_filter_clauses": {
        "type": "boolean"
      },
      "check_duplicates_in_campaigns": {
        "type": "boolean"
      },
      "skip_leads_in_verification": {
        "type": "boolean"
      },
      "limit": {
        "type": "integer",
        "minimum": 1
      },
      "assigned_to": {
        "type": "string",
        "minLength": 1
      },
      "esp_code": {
        "type": "integer"
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Raw Instantly move leads response.

The static output schema is not available. Run `deepline describe instantly_move_leads --json` for the live contract.

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

  ### Output JSON Schema

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

* [Instantly provider guide](https://deepline.com/docs/providers/instantly/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.