> ## Documentation Index
> Fetch the complete documentation index at: https://graine.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Campaigns

> Step-by-step guide to creating and launching campaigns

## Campaign Creation Process

<Steps>
  <Step title="Navigate to Campaigns">
    Click "Campaigns" in the sidebar, then "Create Campaign"
  </Step>

  <Step title="Configure Basic Settings">
    **Campaign Name** Choose a descriptive name (e.g., "Summer Sale Outreach
    2025") **Select Agent** Choose which agent will make the calls **Select Phone
    Numbers** - Choose one or more phone numbers - Multiple numbers enable load
    balancing - If none selected, default numbers will be used
  </Step>

  <Step title="Set Schedule">
    **Start Date/Time** When the campaign should begin **End Date/Time** When the
    campaign should end **Timezone** ⚠️ All times will be converted to this
    timezone: - Asia/Kolkata (UTC+5:30) - India - America/New\_York (UTC-5:00) -
    EST - Europe/London (UTC+0:00) - UK - And more...
  </Step>

  <Step title="Configure Working Hours">
    **From Hour** Start of calling window (24-hour format, e.g., 9 for 9 AM) **To
    Hour** End of calling window (e.g., 18 for 6 PM) **Days** Calls will be made
    Monday-Sunday by default
  </Step>

  <Step title="Set Retry Settings">
    **Max Retry Count** How many times to retry failed calls (default: 5)
    **Cooldown Minutes** Time between retry attempts (default: 45 minutes)
    <Note>Failed calls will only be retried during working hours</Note>
  </Step>

  <Step title="Upload Calling List">
    After creating the campaign, you'll be directed to the calling list page.
    Upload your contacts via: - CSV upload (recommended) - Manual entry - API for
    large lists (contact support)
  </Step>

  <Step title="Launch Campaign">
    Review settings and click "Start Campaign"
  </Step>
</Steps>

## Campaign Dashboard

View all campaigns with:

* Campaign name and status
* Total calls, completed, failed
* Progress indicators
* Start/stop controls

## Campaign Actions

<CardGroup cols={2}>
  <Card title="Start" icon="play">
    Begin making calls
  </Card>

  <Card title="Pause" icon="pause">
    Temporarily stop (can resume later)
  </Card>

  <Card title="Stop" icon="stop">
    End campaign (cannot be resumed)
  </Card>

  <Card title="Export" icon="download">
    Download call results as CSV
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Start Small - Test First">
    Always test with a small list (10-20 contacts) before launching a full campaign. This helps catch issues early.
  </Accordion>

  <Accordion title="Respect Working Hours">
    * Set appropriate calling windows - Honor local timezones - Avoid early
      mornings and late evenings - Follow do-not-call regulations
  </Accordion>

  <Accordion title="Configure Smart Retries">
    * Use moderate retry counts (3-5) - Set appropriate cooldown periods (45-60
      minutes) - More retries don't always mean better results
  </Accordion>

  <Accordion title="Use Multiple Phone Numbers">
    For larger campaigns, use multiple phone numbers to: - Distribute call load -
    Improve deliverability - Reduce call blocking
  </Accordion>

  <Accordion title="Verify CSV Format">
    Ensure your CSV has all required columns and correct formatting before upload.
    See CSV Format guide.
  </Accordion>

  <Accordion title="Test Your Agent Thoroughly">
    Make several test calls before launching a campaign to ensure your agent handles all scenarios correctly.
  </Accordion>
</AccordionGroup>

## Monitoring Campaigns

Track your campaign in real-time:

* **Total Calls**: Number of contacts in list
* **Completed**: Successful calls made
* **Failed**: Calls that failed
* **Pending**: Calls waiting to be made
* **Progress**: Visual progress bar

## Next Steps

<CardGroup cols={2}>
  <Card title="CSV Format Guide" icon="file-csv" href="/campaigns/csv-format">
    Learn how to format your calling list
  </Card>

  <Card title="Custom Variables" icon="brackets-curly" href="/campaigns/custom-variables">
    Personalize conversations with variables
  </Card>
</CardGroup>