# Deadline Funnel

Deadline Funnel provides tools to create authentic, personalized deadlines for marketing campaigns, enhancing urgency and conversions.

- **Category:** marketing automation
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `DEADLINE_FUNNEL`
- **Version:** 20260211_00

## Tools

### Email Link Redirect

**Slug:** `DEADLINE_FUNNEL_EMAIL_LINK_REDIRECT`

Tool to redirect an email link to the correct before- or after-deadline URL for a subscriber. Use when processing clicks on Deadline Funnel email links. Returns the final destination URL after redirects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | string | Yes | Unique token in the email link generated per campaign (e.g., '5e532900'). |
| `utm_term` | string | No | UTM term parameter for analytics (optional). |
| `utm_medium` | string | No | UTM medium parameter for analytics (optional). |
| `utm_source` | string | No | UTM source parameter for analytics (optional). |
| `utm_content` | string | No | UTM content parameter for analytics (optional). |
| `utm_campaign` | string | No | UTM campaign parameter for analytics (optional). |
| `subscriber_email` | string | Yes | Subscriber's email address (ESP placeholder or literal email). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Sales Tracking Webhook URL

**Slug:** `DEADLINE_FUNNEL_GENERATE_SALES_TRACKING_WEBHOOK_URL`

Tool to generate the sales-tracking webhook URL details. Use when you need the campaign-specific sales-tracking webhook parameters before tracking a sale. Use after creating or retrieving your campaign in Deadline Funnel to obtain the token value.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Identifier for the Deadline Funnel campaign to generate the sales-tracking webhook URL for. |
| `integration` | string | Yes | Integration slug used in the webhook (e.g., 'ontraport', 'make'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account ID

**Slug:** `DEADLINE_FUNNEL_GET_ACCOUNT_ID`

Tool to retrieve the Deadline Funnel account ID. Use when you need the account identifier for subsequent API calls. Attempts known endpoints then falls back to parsing response or request headers.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `DEADLINE_FUNNEL_LIST_CAMPAIGNS`

Tool to retrieve existing Deadline Funnel campaigns. Use when you need to obtain campaign IDs and names for downstream actions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Deadline via Custom Webhook

**Slug:** `DEADLINE_FUNNEL_START_DEADLINE_CUSTOM_WEBHOOK`

Tool to start an individual subscriber’s deadline tracking via a custom webhook URL. Use after generating a campaign-specific webhook token. Example: StartDeadlineCustomWebhook(account_id='123456', token='abcdef', email='joe@example.com')

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Subscriber's email address. Must be a valid email format. |
| `token` | string | Yes | Unique custom webhook token for the specific campaign. |
| `account_id` | string | Yes | Your Deadline Funnel account ID (numeric string) as it appears in your webhook URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Track Sale Webhook

**Slug:** `DEADLINE_FUNNEL_TRACK_SALE_WEBHOOK`

Tool to record a sale for a subscriber in a specific campaign via the campaign-generated sales-tracking webhook. Use after generating the campaign sales-tracking webhook URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber associated with this sale. |
| `token` | string | Yes | Token provided by Deadline Funnel; part of the generated webhook URL. |
| `amount` | number | Yes | Sale amount to record; must be non-negative. |
| `currency` | string | Yes | ISO currency code for the sale (e.g., 'USD'). |
| `contact_id` | string | No | External CRM or platform contact identifier (optional). |
| `first_name` | string | No | Subscriber's first name (optional). |
| `campaign_id` | string | Yes | Identifier for the Deadline Funnel campaign; part of the generated webhook URL. |
| `integration` | string | Yes | Integration slug as in the generated webhook URL (e.g., 'ontraport', 'make'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |