# Instantly Bulk Mailbox Config (`daniel999/instantly-bulk-config`) Actor
Update signatures, sending limits, warmup, and reply-to on hundreds of Instantly.ai mailboxes in one run. Filter by domain, tag, or email list.
- **URL**: https://apify.com/daniel999/instantly-bulk-config.md
- **Developed by:** [Daniel999](https://apify.com/daniel999) (community)
- **Categories:** Automation, Integrations, Other
- **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $200.00 / 1,000 mailbox configureds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Instantly Bulk Mailbox Config
Stop copy-pasting signatures, sending limits, and warmup settings into your Instantly mailboxes one by one. This actor updates hundreds of mailboxes at once from a single template, with optional per-mailbox personalization.
Built for cold email agencies and senders running 50 or more mailboxes on Instantly.ai.
**Only the fields you fill in get changed. Everything else stays.**
### How to use
1. Install the [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) Chrome extension.
2. Log into Instantly. On `app.instantly.ai`, click the Cookie-Editor icon, then Export, JSON.
3. Paste the JSON into the **Instantly cookies** field.
4. Choose which mailboxes to target.
5. Fill the fields you want to change.
6. Optional: turn on Dry run for a preview before applying.
Cookies last roughly a week. Re-export from Cookie-Editor if you get an auth error. Or use your Instantly email and password in the fallback fields. SSO and 2FA accounts must use cookies.
### Mailbox filters
Choose which mailboxes to update:
- **All mailboxes** in the workspace
- **By domain**, e.g. `acme.com` matches `jane@acme.com`, `bob@acme.com`
- **By tag**, matches mailboxes that carry any of the tag names you provide
- **By explicit email list**, exact addresses only
### What you can change
Leave any field blank to skip it. Empty fields are not touched on the mailbox.
**Mailbox identity**
- Signature (HTML, supports personalization)
- First name
- Last name
- Reply-to address
**Sending behavior**
- Daily sending limit, max emails per day
- Sending gap, minimum minutes between sends
- Custom tracking domain
- Inbox placement test limit
**Warmup**
- Warmup daily limit
- Warmup increment
- Warmup reply rate
- Warmup custom filter tag
- Enable slow ramp
**Warmup advanced**
- Weekday only, only send Monday to Friday
- Read emulation, simulate recipient reading the email
- Warm custom tracking domain
- Open rate (%)
- Spam save rate (%)
- Important rate (%)
### Personalization
Signature, first name, last name, and reply-to support placeholders that get filled in per mailbox. For an example mailbox `jane@acme.com`:
- `{{email}}` becomes `jane@acme.com`
- `{{first_name}}` becomes the existing first name on the mailbox
- `{{last_name}}` becomes the existing last name on the mailbox
- `{{domain}}` becomes `acme.com`
- `{{local_part}}` becomes `jane`
Example signature that renders differently for each mailbox:
```html
Best,
{{first_name}} {{last_name}}
{{email}}
````
If a placeholder has no value (e.g. `{{first_name}}` on a mailbox without a name set), the actor warns at the end of the run and lists affected mailboxes so you can fix them.
### Output
One dataset row per matched mailbox. The `status` field is one of:
- `updated`, mailbox was updated successfully. The only billable status.
- `dry_run`, preview only, no write happened
- `skipped`, no changes were needed or no fields were provided
- `error`, update failed, see the `error` field for the cause
- `aborted`, run was stopped before reaching this mailbox
- `charge_failed_aborted`, run stopped after a charge failure on a previous mailbox
- `awaiting_configuration`, run had no auth provided
Example row:
```json
{
"email": "jane@acme.com",
"status": "updated",
"fields_updated": ["signature", "daily_limit"],
"chargedCount": 1,
"updatedAt": "2026-05-15T11:30:00.000Z"
}
```
### Pricing
$0.20 per mailbox successfully updated. Dry runs, skips, errors, aborted, and awaiting\_configuration are all free. Re-runs of mailboxes that already match the desired values are also free.
### FAQ
**Can I re-run safely?** Yes. The actor reads the current state of every mailbox and skips ones that already match what you want, so re-running with the same input costs nothing extra.
**What if my run aborts halfway?** Re-run with the same input. Mailboxes that were updated successfully are now in the desired state, so they get skipped on the next run.
**Why didn't my mailbox change in the Instantly UI?** Instantly's UI sometimes caches mailbox state. Hard-refresh the page. The dataset row shows what we sent and when.
**How long do cookies last?** Roughly a week. Re-export from Cookie-Editor if you see HTTP 401 in the error column.
**Does this work with Instantly SSO or 2FA accounts?** Use the cookies path. The email/password fallback does not handle SSO or 2FA.
# Actor input Schema
## `instantlyCookies` (type: `string`):
Recommended. Install the Cookie-Editor Chrome extension, log into Instantly, open the extension on app.instantly.ai, click Export, choose JSON, paste the result here.
## `instantlyEmail` (type: `string`):
Used only if cookies are not provided. Your Instantly login email.
## `instantlyPassword` (type: `string`):
Used only if cookies are not provided. Your Instantly login password.
## `filterMode` (type: `string`):
Which mailboxes to apply the config to.
## `filterDomains` (type: `array`):
Used when filter mode is 'by\_domain'. List domains (with or without @). Example: acme.com, @example.org
## `filterTags` (type: `array`):
Used when filter mode is 'by\_tag'. Match mailboxes that have any of these tag names (or tag IDs).
## `filterEmails` (type: `array`):
Used when filter mode is 'by\_emails'. Exact email addresses to target.
## `signature` (type: `string`):
HTML signature to set. Supports variables: {{email}}, {{first\_name}}, {{last\_name}}, {{local\_part}}, {{domain}}. Leave empty to skip.
## `nameFirst` (type: `string`):
Sets the first name on every matched mailbox. Supports the same template variables as signature. Leave empty to skip.
## `nameLast` (type: `string`):
Sets the last name. Supports template variables. Leave empty to skip.
## `dailyLimit` (type: `integer`):
Max emails per day per mailbox. Leave blank to skip.
## `sendingGap` (type: `integer`):
Minimum minutes between sends. Leave blank to skip.
## `replyTo` (type: `string`):
Override reply-to. Supports template variables. Leave blank to skip.
## `warmupIncrement` (type: `integer`):
Daily warmup increment. Leave blank to skip.
## `warmupLimit` (type: `integer`):
Daily warmup cap. Leave blank to skip.
## `warmupCustomFtag` (type: `string`):
Custom filter tag for warmup pool. Leave blank to skip.
## `warmupReplyRatePercent` (type: `integer`):
Percentage of warmup emails that get a simulated reply. Leave blank to skip.
## `enableSlowRamp` (type: `string`):
Whether warmup ramps up gradually.
## `inboxPlacementTestLimit` (type: `integer`):
Inbox placement testing daily cap. Leave blank to skip.
## `cTdomain` (type: `string`):
Custom click tracking domain. Leave blank to skip.
## `warmupAdvancedWeekdayOnly` (type: `string`):
Restrict warmup sends to weekdays.
## `warmupAdvancedReadEmulation` (type: `string`):
Simulate the recipient reading the email.
## `warmupAdvancedWarmCtd` (type: `string`):
Warm the custom tracking domain.
## `warmupAdvancedOpenRate` (type: `integer`):
Simulated open rate percentage.
## `warmupAdvancedSpamSaveRate` (type: `integer`):
Rate at which warmup emails landing in spam are auto-moved to inbox.
## `warmupAdvancedImportantRate` (type: `integer`):
Rate at which warmup emails are marked important.
## `dryRun` (type: `boolean`):
If true, list what would change without calling the update endpoint. Useful for previewing before applying.
## Actor input object example
```json
{
"filterMode": "all",
"filterDomains": [],
"filterTags": [],
"filterEmails": [],
"enableSlowRamp": "unchanged",
"warmupAdvancedWeekdayOnly": "unchanged",
"warmupAdvancedReadEmulation": "unchanged",
"warmupAdvancedWarmCtd": "unchanged",
"dryRun": false
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("daniel999/instantly-bulk-config").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("daniel999/instantly-bulk-config").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{}' |
apify call daniel999/instantly-bulk-config --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=daniel999/instantly-bulk-config",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Instantly Bulk Mailbox Config",
"description": "Update signatures, sending limits, warmup, and reply-to on hundreds of Instantly.ai mailboxes in one run. Filter by domain, tag, or email list.",
"version": "0.1",
"x-build-id": "G4DLaobsebbsek7mS"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/daniel999~instantly-bulk-config/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-daniel999-instantly-bulk-config",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/daniel999~instantly-bulk-config/runs": {
"post": {
"operationId": "runs-sync-daniel999-instantly-bulk-config",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/daniel999~instantly-bulk-config/run-sync": {
"post": {
"operationId": "run-sync-daniel999-instantly-bulk-config",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"filterMode"
],
"properties": {
"instantlyCookies": {
"title": "Instantly cookies (JSON)",
"type": "string",
"description": "Recommended. Install the Cookie-Editor Chrome extension, log into Instantly, open the extension on app.instantly.ai, click Export, choose JSON, paste the result here."
},
"instantlyEmail": {
"title": "Instantly email (fallback)",
"type": "string",
"description": "Used only if cookies are not provided. Your Instantly login email."
},
"instantlyPassword": {
"title": "Instantly password (fallback)",
"type": "string",
"description": "Used only if cookies are not provided. Your Instantly login password."
},
"filterMode": {
"title": "Mailbox filter mode",
"enum": [
"all",
"by_domain",
"by_tag",
"by_emails"
],
"type": "string",
"description": "Which mailboxes to apply the config to.",
"default": "all"
},
"filterDomains": {
"title": "Filter: domains",
"type": "array",
"description": "Used when filter mode is 'by_domain'. List domains (with or without @). Example: acme.com, @example.org",
"default": [],
"items": {
"type": "string"
}
},
"filterTags": {
"title": "Filter: tags",
"type": "array",
"description": "Used when filter mode is 'by_tag'. Match mailboxes that have any of these tag names (or tag IDs).",
"default": [],
"items": {
"type": "string"
}
},
"filterEmails": {
"title": "Filter: emails",
"type": "array",
"description": "Used when filter mode is 'by_emails'. Exact email addresses to target.",
"default": [],
"items": {
"type": "string"
}
},
"signature": {
"title": "Signature (HTML)",
"type": "string",
"description": "HTML signature to set. Supports variables: {{email}}, {{first_name}}, {{last_name}}, {{local_part}}, {{domain}}. Leave empty to skip."
},
"nameFirst": {
"title": "First name",
"type": "string",
"description": "Sets the first name on every matched mailbox. Supports the same template variables as signature. Leave empty to skip."
},
"nameLast": {
"title": "Last name",
"type": "string",
"description": "Sets the last name. Supports template variables. Leave empty to skip."
},
"dailyLimit": {
"title": "Daily sending limit",
"minimum": 0,
"type": "integer",
"description": "Max emails per day per mailbox. Leave blank to skip."
},
"sendingGap": {
"title": "Sending gap (minutes)",
"minimum": 0,
"type": "integer",
"description": "Minimum minutes between sends. Leave blank to skip."
},
"replyTo": {
"title": "Reply-to address",
"type": "string",
"description": "Override reply-to. Supports template variables. Leave blank to skip."
},
"warmupIncrement": {
"title": "Warmup increment",
"minimum": 0,
"type": "integer",
"description": "Daily warmup increment. Leave blank to skip."
},
"warmupLimit": {
"title": "Warmup daily limit",
"minimum": 0,
"type": "integer",
"description": "Daily warmup cap. Leave blank to skip."
},
"warmupCustomFtag": {
"title": "Warmup custom filter tag",
"type": "string",
"description": "Custom filter tag for warmup pool. Leave blank to skip."
},
"warmupReplyRatePercent": {
"title": "Warmup reply rate (%)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Percentage of warmup emails that get a simulated reply. Leave blank to skip."
},
"enableSlowRamp": {
"title": "Enable slow ramp",
"enum": [
"unchanged",
"true",
"false"
],
"type": "string",
"description": "Whether warmup ramps up gradually.",
"default": "unchanged"
},
"inboxPlacementTestLimit": {
"title": "Inbox placement test limit",
"minimum": 0,
"type": "integer",
"description": "Inbox placement testing daily cap. Leave blank to skip."
},
"cTdomain": {
"title": "Custom tracking domain",
"type": "string",
"description": "Custom click tracking domain. Leave blank to skip."
},
"warmupAdvancedWeekdayOnly": {
"title": "Warmup advanced: weekday only",
"enum": [
"unchanged",
"true",
"false"
],
"type": "string",
"description": "Restrict warmup sends to weekdays.",
"default": "unchanged"
},
"warmupAdvancedReadEmulation": {
"title": "Warmup advanced: read emulation",
"enum": [
"unchanged",
"true",
"false"
],
"type": "string",
"description": "Simulate the recipient reading the email.",
"default": "unchanged"
},
"warmupAdvancedWarmCtd": {
"title": "Warmup advanced: warm CTD",
"enum": [
"unchanged",
"true",
"false"
],
"type": "string",
"description": "Warm the custom tracking domain.",
"default": "unchanged"
},
"warmupAdvancedOpenRate": {
"title": "Warmup advanced: open rate",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Simulated open rate percentage."
},
"warmupAdvancedSpamSaveRate": {
"title": "Warmup advanced: spam save rate",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Rate at which warmup emails landing in spam are auto-moved to inbox."
},
"warmupAdvancedImportantRate": {
"title": "Warmup advanced: important rate",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Rate at which warmup emails are marked important."
},
"dryRun": {
"title": "Dry run",
"type": "boolean",
"description": "If true, list what would change without calling the update endpoint. Useful for previewing before applying.",
"default": false
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```