Beehiiv Subscriber

Subscribe users to a Beehiiv newsletter with just a few inputs. This task supports single or multithreaded processing, along with full customization via headers, user-agents, cookies, and proxy.

Endpoint

POST https://api.crawlbyte.ai/api/tasks

Basic Configuration (Required)

{
  "type": "beehiiv",
  "url": "https://link.beehiiv.com/subscribe",
  "input": [
    "[email protected]",
    "[email protected]"
  ],
  "multithread": false
}

Parameters

Field	Type	Description
type	string	Always "beehiiv"
url	string	Target Beehiiv subscribe form URL
input	array	Array of emails to be subscribed
multithread	boolean	Use true for faster processing with multiple threads

Advanced Configuration (Optional)

{
  "type": "beehiiv",
  "url": "https://link.beehiiv.com/subscribe",
  "input": [
    "[email protected]"
  ],
  "multithread": true,
  "user_agent_preset": "chrome",
  "user_agent_custom": "",
  "headers": "{\"Authorization\":\"Bearer abc123\",\"X-Custom-Header\":\"value\"}",
  "cookie": "session_id=xyz123; token=abc456",
  "proxy": "username:password@ip:port"
}

Optional Parameters

Field	Type	Description
user_agent_preset	string	Preset user-agent. Options: chrome, firefox, edge, opera, safari, ios-safari, android-chrome, custom
user_agent_custom	string	Used if user_agent_preset is custom.
headers	string	JSON-formatted string of headers.
cookie	string	key=value;
proxy	string	username:password@ip:port

Pricing

• $0.01 per successful task This is a pay-as-you-go pricing model — you're only charged when a Beehiiv task successfully submits email addresses.

You can view your current credit balance and usage history in the Crawlbyte Dashboard.

Response

The response object contains metadata about the task, but for beehiiv type, the most relevant field is status, which determines task progress.

{
  "id": "bd3e89ed-815e-4395-98a3-521ede71cc4d",
  "status": "queued"
}

Status Types

Status	Meaning
queued	Task was accepted and added to the processing queue.
processing	Task is currently running.
completed	Task finished successfully (emails were submitted to Beehiiv).
failed	Task encountered an error (e.g. bad proxy, invalid URL, etc.).

Polling

If the initial status is queued or processing, you should poll for task completion.

GET https://api.crawlbyte.ai/api/tasks/:id

• You’ll receive the same structure with an updated status.

• Only poll until you receive completed or failed.

• Recommended interval: every 3–5 seconds.

SDK Usage

You can run this task using any official Crawlbyte SDK:

• Go SDK

• TypeScript SDK

• Python SDK

Each SDK provides a simple way to:

• Create the task

• Poll for status

• Handle the final result

Refer to the SDKs section for installation, examples, and setup instructions.

Notes

• If you leave advanced settings blank, Crawlbyte will automatically assign optimal headers, user-agent, and fingerprinting.

• multithread: true is recommended for faster processing — especially when submitting larger email batches.

• Incorrect proxy, malformed headers, or invalid cookie format will cause the task to fail.

• Only use custom proxy, headers, or cookies if needed — default settings work best in most cases.