Developer recipe

Broadcast to a pipeline stage

Send a personalized update to the reachable contacts in one pipeline stage without assembling a contact list by hand.

Result
Every reachable contact in the selected stage receives one message personalized with their name.
Time
7 minutes
Key scopes
readsend

Use this for a known audience

A broadcast sends immediately and is capped at 30 recipients per request. Use it for a deliberate segment such as qualified leads, not as a substitute for consent or audience review.

1. Find the stage key and sending account

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/pipeline" \
  -H "Authorization: Bearer $GRAMCLAW_API_KEY"

curl -s "$GRAMCLAW_BASE_URL/api/v1/me" \
  -H "Authorization: Bearer $GRAMCLAW_API_KEY"

2. Send the broadcast

Replace the account and stage values with IDs returned above. {{name}} is resolved separately for each recipient.

Terminal
curl -s "$GRAMCLAW_BASE_URL/api/v1/broadcast" \
  -H "Authorization: Bearer $GRAMCLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qualified-update-001" \
  -d '{
    "account_id": "replace_with_account_id",
    "audience_type": "stage",
    "audience_ref": "qualified",
    "message_text": "Hi {{name}}, I wanted to share the update we discussed. Is now a good time?"
  }'
  • The response reports recipients, audience_total, and whether the audience was capped.
  • Suppressed or inaccessible contacts are not sent a message.
  • Use a campaign instead when the audience exceeds 30 people or needs follow-ups.
Chat on Telegram