First Submission Actions

First submission actions run after a lead passes initial qualification but before delivery. They let you verify or enrich lead data before sending it to the client.

Action Types

Configuration

Navigate to the campaign's Overview tab and find the First Submission Action section.

1. Toggle Enable first submission action
2. Select the action type
3. Configure action-specific settings (see below)

Voice AI / SMS AI

When voice or SMS AI is selected, the campaign's configured AI agent is triggered. The agent uses soft qualification — only hard-stop DQ rules are checked upfront, and the AI agent collects any missing data during the conversation.

The campaign must have an AI agent configured in the AI Agents tab for the selected channel.

Human Review

Sends the lead to the manual review queue where a team member can approve or reject it.

• Priority — High, normal, or low
• Reason — Optional note explaining why review is needed

Reviewed leads can then be manually delivered or rejected.

Webhook

Calls an external URL when a lead is submitted, allowing external systems to process or enrich the lead.

• URL — The webhook endpoint
• Method — POST or PUT
• Headers — Custom headers (e.g., authentication)
• Timeout — 1 to 300 seconds (default: 30)
• Retries — 0 to 5 retry attempts (default: 3)

Webhook Payload

The webhook receives a JSON payload with the lead's data:

{
  "leadId": "lead_abc123",
  "submissionId": "sub_xyz789",
  "campaignId": "ABC",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "phone": "+15551234567",
  "status": "pending_action",
  "isTest": false,
  "firstSubmissionAction": {
    "action": "webhook",
    "triggeredAt": "2024-06-15T10:30:00Z"
  }
}

When Actions Run

First submission actions only run on the initial submission flow. They are skipped for:

• Manual delivery (POST /leads/{leadId}/deliver)
• Repost (POST /leads/{leadId}/repost)
• Leads that fail DQ conditionals (disqualified before the action stage)