> ## 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 Campaign Management: Inputs, Cost & CLI Example

> Creating an Instantly campaign from a shared campaign. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## 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=instantly_create_from_shared:{}' --json
```

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

## Input Schema

| Name                  | Type     | Required | Default | Description |
| --------------------- | -------- | -------- | ------- | ----------- |
| `payload.id`          | `string` | No       |         |             |
| `payload.campaign_id` | `string` | No       |         |             |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Create an Instantly campaign from a shared campaign.",
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1
      },
      "campaign_id": {
        "type": "string",
        "minLength": 1
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

Output schema is not available yet.

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

  ### Output JSON Schema

  ```json theme={null}
  {
    "description": "Raw Instantly create from shared response."
  }
  ```
</details>

## Advanced: Direct CLI

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

```bash theme={null}
deepline tools execute instantly_create_from_shared --payload '{}' --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.                      |

## Provider API Context

<details>
  <summary>Show provider reference (optional)</summary>

  ```md theme={null}
  > A campaign that can be sent to a list of recipients

  Manage campaigns for sending to lists of recipients. These endpoints let you create, list, update, and delete campaigns, as well as activate, pause, share, duplicate, and export them. You can also search campaigns by lead email, manage campaign variables, and check sending status.

  ## Related schemas

  * [Campaign](/api-reference/schemas/campaign) — full field reference for campaign objects

  ## Endpoints

  | Method | Endpoint                                | Description                           |
  | ------ | --------------------------------------- | ------------------------------------- |
  | POST   | `/api/v2/campaigns`                     | Create campaign                       |
  | GET    | `/api/v2/campaigns`                     | List campaign                         |
  | GET    | `/api/v2/campaigns/{id}`                | Get campaign                          |
  | PATCH  | `/api/v2/campaigns/{id}`                | Patch campaign                        |
  | DELETE | `/api/v2/campaigns/{id}`                | Delete campaign                       |
  | POST   | `/api/v2/campaigns/{id}/activate`       | Activate(start), or resume a campaign |
  | POST   | `/api/v2/campaigns/{id}/pause`          | Stop(or pause) a campaign             |
  | GET    | `/api/v2/campaigns/search-by-contact`   | Search campaigns by lead email        |
  | POST   | `/api/v2/campaigns/{id}/share`          | Share a campaign                      |
  | POST   | `/api/v2/campaigns/{id}/from-export`    | Create campaign from shared one       |
  | POST   | `/api/v2/campaigns/{id}/export`         | Export campaign to JSON format        |
  | POST   | `/api/v2/campaigns/{id}/duplicate`      | Duplicate campaign                    |
  | GET    | `/api/v2/campaigns/count-launched`      | Get launched campaigns count          |
  | POST   | `/api/v2/campaigns/{id}/variables`      | Add campaign variables                |
  | GET    | `/api/v2/campaigns/{id}/sending-status` | Get campaign sending status           |

  ## 96. CRM Actions

  Source: https://developer.instantly.ai/api-reference/groups/crm-actions.md
  ```
</details>

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