Documentation

DocsAdvanced FeaturesRate Limiting

Rate Limiting

Set daily send limits per inbox or org-wide to protect deliverability. Workflows automatically throttle email sends when the limit is reached.

Send Limits

SendLimit

{
  id: string,
  organizationId: string,
  inboxId: string | null,    // null = org-wide limit
  dailyLimit: number,
  createdAt: string
}

TypeScript

// Set org-wide daily limit
await client.upsertSendLimit({ dailyLimit: 500 });

// Set per-inbox limit
await client.upsertSendLimit({ inboxId: "inb_abc", dailyLimit: 100 });

// List all limits
const limits = await client.listSendLimits();

curl

# Set org-wide limit
curl -X PUT https://api.outreachagent.dev/v1/send-limits \
  -H "Authorization: Bearer $OUTREACHAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dailyLimit": 500}'

# List limits
curl https://api.outreachagent.dev/v1/send-limits \
  -H "Authorization: Bearer $OUTREACHAGENT_API_KEY"

When a send limit is reached, workflow email sends are queued until the next day. The enrollment remains active and resumes automatically.