Before you queue
- Call GET /api/v1/me and copy only the account IDs you intend to use.
- Confirm every recipient is appropriate to contact and remove duplicates from your source list.
- Start with a conservative daily quota and a small test audience.
Queue the campaign
Terminal
export GRAMCLAW_BASE_URL="https://gramclaw.com"
export GRAMCLAW_API_KEY="gc_live_replace_with_your_key"
curl -s "$GRAMCLAW_BASE_URL/api/v1/campaigns" \
-H "Authorization: Bearer $GRAMCLAW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: partner-outreach-001" \
-d '{
"name": "Partner outreach",
"account_pool": ["account_id_one", "account_id_two"],
"message_text": "Hi {{name}}, I noticed your team works with Telegram communities. Open to a quick question?",
"contacts": [
{ "name": "Alex", "identifier": "@alex_username" },
{ "name": "Sam", "identifier": "@sam_username" }
],
"daily_quota_per_account": 20
}'- Campaign creation queues work; it does not mean every message sent immediately.
- A campaign accepts up to 5,000 contacts, but account health and relevance still matter more than volume.
- Keep the Idempotency-Key unchanged when retrying the same request.